rename_in: Rename names in a set

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

Rename names in a set

Description

Elements of x whose names are in nm will be renamed.

Usage

rename_in(x, nm, f, ...)

Arguments

x	An object with names.
nm	A character vector passed to %in%.
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_in(c("Two", "Three"), paste0, "x")

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