Set names of a vector

This is equivalent to stats::setNames(), with more features and stricter argument checking.

set_names(x, nm = x, ...)

Vector to name.

nm, ...

Vector of names, the same length as x.

You can specify names in the following ways:

  • If you do nothing, x will be named with itself.

  • If x already has names, you can provide a function or formula to transform the existing names. In that case, ... is passed to the function.

  • If nm is NULL, the names are removed (if present).

  • In all other cases, nm and ... are coerced to character.

Life cycle

set_names() is stable and exported in purrr.

  • set_names
library(rlang) # NOT RUN { set_names(1:4, c("a", "b", "c", "d")) set_names(1:4, letters[1:4]) set_names(1:4, "a", "b", "c", "d") # If the second argument is ommitted a vector is named with itself set_names(letters[1:5]) # Alternatively you can supply a function set_names(1:10, ~ letters[seq_along(.)]) set_names(head(mtcars), toupper) # `...` is passed to the function: set_names(head(mtcars), paste0, "_foo") # }
Documentation reproduced from package rlang, version 0.2.0, License: GPL-3

Community examples

Looks like there are no examples yet.