1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
|
\name{rename}
\alias{rename}
\title{Change Names of a Named Object}
\description{
\code{rename} changes the names of a named object.
}
\usage{
rename(x, \dots, gsub = FALSE, fixed = TRUE, warn = TRUE)
}
\arguments{
\item{x}{Any named object}
\item{\dots}{A sequence of named arguments, all of type character}
\item{gsub}{a logical value; if TRUE, \code{\link{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.
}
\item{fixed}{a logical value, passed to \code{\link{gsub}}. If TRUE,
substitutions are by fixed strings and not by regular expressions.}
\item{warn}{a logical value; should a warning be issued if
those names to change are not found?}
}
\details{
This function changes the names of \code{x} according to the
remaining arguments.
If \code{gsub} is FALSE, argument tags are the \emph{old}
names, the values are the new names.
If \code{gsub} is TRUE, arguments are substrings of the names
that are substituted by the argument values.
}
\value{
The object \code{x} with new names defined by the \dots arguments.
}
\examples{
x <- c(a=1, b=2)
rename(x,a="A",b="B")
# Since version 0.99.22 - the following also works:
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))
# Since version 0.99.22 - the following also works:
str(rename(iris,
Sepal.Length=Sepal_Length,
Sepal.Width =Sepal_Width,
Petal.Length=Petal_Length,
Petal.Width =Petal_Width
))
}
\keyword{manip}
|
