% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/across.R
\name{across}
\alias{across}
\title{Apply a function (or a set of functions) to a set of columns}
\usage{
across(cols = everything(), fns = NULL, names = NULL, ...)
}
\arguments{
\item{cols}{<\code{\link[=dplyr_tidy_select]{tidy-select}}> Columns to transform.
Because \code{across()} is used within functions like \code{summarise()} and
\code{mutate()}, you can't select or compute upon grouping variables.}
\item{fns}{Functions to apply to each of the selected columns.
Possible values are:
\itemize{
\item \code{NULL}, to returns the columns untransformed.
\item A function, e.g. \code{mean}.
\item A purrr-style lambda, e.g. \code{~ mean(.x, na.rm = TRUE)}
\item A list of functions/lambdas, e.g.
\verb{list(mean = mean, n_miss = ~ sum(is.na(.x))}
}
Within these functions you can use \code{\link[=cur_column]{cur_column()}} and \code{\link[=cur_group]{cur_group()}}
to access the current column and grouping keys respectively.}
\item{names}{A glue specification that describes how to name the output
columns. This can use \code{{col}} to stand for the selected column name, and
\code{{fn}} to stand for the name of the function being applied. The default
(\code{NULL}) is equivalent to \code{"{col}"} for the single function case and
\code{"{col}_{fn}"} for the case where a list is used for \code{fns}.}
\item{...}{Additional arguments for the function calls in \code{fns}.}
}
\value{
A tibble with one column for each column in \code{cols} and each function in \code{fns}.
}
\description{
\code{across()} makes it easy to apply the same transformation to multiple
columns, allowing you to use \code{\link[=select]{select()}} semantics inside in \code{\link[=summarise]{summarise()}} and
\code{\link[=mutate]{mutate()}}. \code{across()} supersedes the family of "scoped variants" like
\code{summarise_at()}, \code{summarise_if()}, and \code{summarise_all()}.
See \code{vignette("colwise")} for more details.
}
\examples{
# A function
iris \%>\%
group_by(Species) \%>\%
summarise(across(starts_with("Sepal"), mean))
iris \%>\%
as_tibble() \%>\%
mutate(across(is.factor, as.character))
# A purrr-style formula
iris \%>\%
group_by(Species) \%>\%
summarise(across(starts_with("Sepal"), ~mean(.x, na.rm = TRUE)))
# A named list of functions
iris \%>\%
group_by(Species) \%>\%
summarise(across(starts_with("Sepal"), list(mean = mean, sd = sd)))
# Use the names argument to control the output names
iris \%>\%
group_by(Species) \%>\%
summarise(across(starts_with("Sepal"), mean, names = "mean_{col}"))
iris \%>\%
group_by(Species) \%>\%
summarise(across(starts_with("Sepal"), list(mean = mean, sd = sd), names = "{col}.{fn}"))
iris \%>\%
group_by(Species) \%>\%
summarise(across(starts_with("Sepal"), list(mean, sd), names = "{col}.fn{fn}"))
}