R: Change Names of a Named Object

Rename {DescTools} | R Documentation

## Change Names of a Named Object

### Description

`Rename` changes the names of a named object.

### Usage

    Rename(x, ..., gsub = FALSE, fixed = TRUE, warn = TRUE)

### Arguments

`x` | Any named object
`...` | A sequence of named arguments, all of type character
`gsub` | a logical value; if TRUE, `gsub` is used to change the row and column labels of the resulting table. That is, instead of substituting whole names, substrings of the names of the object can changed.
`fixed` | a logical value, passed to `gsub`. If TRUE, substitutions are by fixed strings and not by regular expressions.
`warn` | a logical value; should a warning be issued if those names to change are not found?

### Details

This function changes the names of `x` according to the remaining arguments. If `gsub` is FALSE, argument tags are the old names, the values are the new names. If `gsub` is TRUE, arguments are substrings of the names that are substituted by the argument values.

### Value

The object `x` with new names defined by the ... arguments.

### Note

This function was previously published in the package memisc as `rename` and has been integrated here without logical changes.

### Author(s)

Martin Elff <melff@essex.ac.uk>

### See Also

`SetNames`, `Recode` for recoding of a factor (renaming or combining levels)

### Examples

    x <- c(a=1, b=2)
    Rename(x, a="A", b="B")

    str(Rename( iris,
                Sepal.Length="Sepal_Length",
                Sepal.Width ="Sepal_Width",
                Petal.Length="Petal_Length",
                Petal.Width ="Petal_Width"
                ))

    str(Rename(iris, .="_", gsub=TRUE))

[Package DescTools version 0.99.36 Index]