https://github.com/hadley/dplyr
Tip revision: ccde22c8d1c27ec0c80e97d30f8d84879a245a16 authored by Kirill Müller on 18 August 2018, 08:43:10 UTC
Bump version
Bump version
Tip revision: ccde22c
se-deprecated.Rd
% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/count-tally.R, R/distinct.R, R/do.r, R/funs.R,
% R/group-by.r, R/group-indices.R, R/manip.r, R/reexport-tidyselect.R
\name{tally_}
\alias{tally_}
\alias{count_}
\alias{add_tally_}
\alias{add_count_}
\alias{distinct_}
\alias{do_}
\alias{funs_}
\alias{group_by_}
\alias{group_indices_}
\alias{filter_}
\alias{slice_}
\alias{summarise_}
\alias{summarize_}
\alias{mutate_}
\alias{transmute_}
\alias{arrange_}
\alias{select_}
\alias{rename_}
\alias{se-deprecated}
\alias{select_vars_}
\alias{rename_vars_}
\title{Deprecated SE versions of main verbs.}
\usage{
tally_(x, wt, sort = FALSE)
count_(x, vars, wt = NULL, sort = FALSE)
add_tally_(x, wt, sort = FALSE)
add_count_(x, vars, wt = NULL, sort = FALSE)
distinct_(.data, ..., .dots, .keep_all = FALSE)
do_(.data, ..., .dots = list())
funs_(dots, args = list(), env = base_env())
group_by_(.data, ..., .dots = list(), add = FALSE)
group_indices_(.data, ..., .dots = list())
filter_(.data, ..., .dots = list())
slice_(.data, ..., .dots = list())
summarise_(.data, ..., .dots = list())
summarize_(.data, ..., .dots = list())
mutate_(.data, ..., .dots = list())
transmute_(.data, ..., .dots = list())
arrange_(.data, ..., .dots = list())
select_(.data, ..., .dots = list())
rename_(.data, ..., .dots = list())
select_vars_(vars, args, include = chr(), exclude = chr())
rename_vars_(vars, args)
}
\arguments{
\item{x}{a \code{\link[=tbl]{tbl()}} to tally/count.}
\item{wt}{(Optional) If omitted (and no variable named \code{n} exists in the
data), will count the number of rows.
If specified, will perform a "weighted" tally by summing the
(non-missing) values of variable \code{wt}. A column named \code{n} (but not \code{nn} or
\code{nnn}) will be used as weighting variable by default in \code{tally()}, but not
in \code{count()}. This argument is automatically \link[rlang:quo]{quoted} and later
\link[rlang:eval_tidy]{evaluated} in the context of the data
frame. It supports \link[rlang:quasiquotation]{unquoting}. See
\code{vignette("programming")} for an introduction to these concepts.}
\item{sort}{if \code{TRUE} will sort output in descending order of \code{n}}
\item{vars}{Various meanings depending on the verb.}
\item{.data}{A data frame.}
\item{.keep_all}{If \code{TRUE}, keep all variables in \code{.data}.
If a combination of \code{...} is not distinct, this keeps the
first row of values.}
\item{dots, .dots, ...}{Pair/values of expressions coercible to lazy objects.}
\item{args}{Various meanings depending on the verb.}
\item{env}{The environment in which functions should be evaluated.}
\item{add}{When \code{add = FALSE}, the default, \code{group_by()} will
override existing groups. To add to the existing groups, use
\code{add = TRUE}.}
\item{include, exclude}{Character vector of column names to always
include/exclude.}
}
\description{
dplyr used to offer twin versions of each verb suffixed with an
underscore. These versions had standard evaluation (SE) semantics:
rather than taking arguments by code, like NSE verbs, they took
arguments by value. Their purpose was to make it possible to
program with dplyr. However, dplyr now uses tidy evaluation
semantics. NSE verbs still capture their arguments, but you can now
unquote parts of these arguments. This offers full programmability
with NSE verbs. Thus, the underscored versions are now superfluous.
}
\details{
Unquoting triggers immediate evaluation of its operand and inlines
the result within the captured expression. This result can be a
value or an expression to be evaluated later with the rest of the
argument. See \code{vignette("programming")} for more information.
}
\keyword{internal}