Learn R Programming

stats (version 3.3.1)

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