select_all
Select and rename a selection of variables
Description
![[Superseded]](../help/figures/lifecycle-superseded.svg)
rename_if(), rename_at(), and rename_all() have been superseded by
rename_with(). The matching select statements have been superseded by the
combination of a select() + rename_with().
These functions were superseded because mutate_if() and friends were
superseded by across(). select_if() and rename_if() already use tidy
selection so they can't be replaced by across() and instead we need a new
function.
Usage
select_all(.tbl, .funs = list(), ...) rename_all(.tbl, .funs = list(), ...) select_if(.tbl, .predicate, .funs = list(), ...) rename_if(.tbl, .predicate, .funs = list(), ...) select_at(.tbl, .vars, .funs = list(), ...) rename_at(.tbl, .vars, .funs = list(), ...)
Arguments
.tbl |
A |
.funs |
A function |
... |
Additional arguments for the function calls in
|
.predicate |
A predicate function to be applied to the columns
or a logical vector. The variables for which |
.vars |
A list of columns generated by |
Examples
mtcars <- as_tibble(mtcars) # for nicer printing
mtcars %>% rename_all(toupper)
# ->
mtcars %>% rename_with(toupper)
# NB: the transformation comes first in rename_with
is_whole <- function(x) all(floor(x) == x)
mtcars %>% rename_if(is_whole, toupper)
# ->
mtcars %>% rename_with(toupper, where(is_whole))
mtcars %>% rename_at(vars(mpg:hp), toupper)
# ->
mtcars %>% rename_with(toupper, mpg:hp)
# You now must select() and then rename
mtcars %>% select_all(toupper)
# ->
mtcars %>% rename_with(toupper)
# Selection drops unselected variables:
mtcars %>% select_if(is_whole, toupper)
# ->
mtcars %>% select(where(is_whole)) %>% rename_with(toupper)
mtcars %>% select_at(vars(-contains("ar"), starts_with("c")), toupper)
# ->
mtcars %>%
select(!contains("ar") | starts_with("c")) %>%
rename_with(toupper)