rename_starting: Rename names that start with a prefix

In hughjonesd/rumpel: Easily Rename and Subset Objects by Name

Rename names that start with a prefix

Description

Rename names that start with a prefix

Usage

rename_starting(x, prefix, f, ...)

Arguments

x	An object with names.
prefix	A string.
f	A function, one-sided formula, or character vector.
...	Passed into f. An error is thrown if ... is non-empty when f is a character vector.

Details

• If f is a function it will be applied to the selected names. If it is a formula and the 'rlang' package is installed, it will be converted to a function by rlang::as_function(), then applied.

• If f is a named character vector like c(new_name = "old_name", ...) then "old_name" will become "new_name", as in dplyr::rename().

• If f is an unnamed character vector, these will be the new names in order.

Value

The renamed object.

Examples

vec <- c("One" = 1, "Two" = 2, "Three" = 3, "Four" = 4)
vec |> rename_starting("T", tolower)

hughjonesd/rumpel documentation built on Jan. 22, 2025, 1:12 a.m.