Last chance! 50% off unlimited learning
Sale ends in
rename()
changes the names of individual variables using
new_name = old_name
syntax; rename_with()
renames columns using a
function.
rename(.data, ...)rename_with(.data, .fn, .cols = everything(), ...)
An object of the same type as .data
. The output has the following
properties:
Rows are not affected.
Column names are changed; column order is preserved.
Data frame attributes are preserved.
Groups are updated to reflect new names.
A data frame, data frame extension (e.g. a tibble), or a lazy data frame (e.g. from dbplyr or dtplyr). See Methods, below, for more details.
For rename()
: <tidy-select
> Use
new_name = old_name
to rename selected variables.
For rename_with()
: additional arguments passed onto .fn
.
A function used to transform the selected .cols
. Should
return a character vector the same length as the input.
<tidy-select
> Columns to rename;
defaults to all columns.
This function is a generic, which means that packages can provide implementations (methods) for other classes. See the documentation of individual methods for extra arguments and differences in behaviour.
The following methods are currently available in loaded packages: dplyr:::methods_rd("rename").
Other single table verbs:
arrange()
,
filter()
,
mutate()
,
select()
,
slice()
,
summarise()
iris <- as_tibble(iris) # so it prints a little nicer
rename(iris, petal_length = Petal.Length)
rename_with(iris, toupper)
rename_with(iris, toupper, starts_with("Petal"))
rename_with(iris, ~ tolower(gsub(".", "_", .x, fixed = TRUE)))
Run the code above in your browser using DataLab