Learn R Programming

stats (version 3.3)

setNames: Set the Names in an Object

Description

This is a convenience function that sets the names on an object and returns the object. It is most useful at the end of a function definition where one is creating the object to be returned and would prefer not to store it under a name just so the names can be assigned.

Usage

setNames(object = nm, nm)

Arguments

object
an object for which a names attribute will be meaningful
nm
a character vector of names to assign to the object

Value

  • An object of the same sort as object with the new names assigned.

See Also

unname for removing names.

Examples

Run this code
setNames( 1:3, c("foo", "bar", "baz") )
# this is just a short form of
tmp <- 1:3
names(tmp) <-  c("foo", "bar", "baz")
tmp

## special case of character vector, using default
setNames(nm = c("First", "2nd"))

Run the code above in your browser using DataLab