Package dplyr version 1.1.4
Parameters
R
mutate(.data, ...)
## S3 method for class 'data.frame'
mutate(
.data,
...,
.by = NULL,
.keep = c("all", "used", "unused", "none"),
.before = NULL,
.after = NULL
)参数【.data】：数据集、数据集扩展（如 tibble）或懒数据集（如来自 dbplyr 或 dtplyr 的数据集）。
参数【...】：<data-masking> 键值对。键名给输出结果的列命名。值可以是：
- 长度为 1 的向量，该向量的元素数量的整数倍必须是数据集的行数。
- 与当前分组（或整个数据集，如果未分组）长度相同的向量。
- NULL，表示删除该列。
- 数据集或 tibble，用于在输出中创建多列。
参数【.by】：<tidy-select> 可选的参数，仅用于此操作的列分组选择，可替代 group_by()。
参数【.keep】：控制输出中保留参数【.data】中的哪些列。分组列和由参数【...】创建的列始终保留。
- "all" 保留参数【.data】中的所有列。这是默认设置。
- "used" 只保留参数【...】中使用的列，以创建新列。这对检查工作非常有用，因为它可以并排显示输入和输出。
- "unused" 只保留参数【...】中未使用的列，以创建新列。如果您生成了新列，但不再需要用于生成新列的列，这将非常有用。
- "none" 不会保留参数【.data】中的任何额外列。只保留分组变量和由参数【...】创建的列。
参数【.before】和参数【.after】：<tidy-select> 可选控制新列的显示位置（默认添加到右侧）。更多详情，请参阅 relocate()。
Value
与参数【.data】类型相同的对象。输出具有以下属性：
- 将根据参数【.keep】保留参数【.data】中的列。
- 被参数【...】修改的现有列始终会返回到其原始位置。
- 通过参数【...】创建的新列将根据参数【.before】和参数【.after】放置。
- 行数不受影响。
- 赋值为 NULL 的列将被删除。
- 如果分组变量发生变化，将重新计算分组。
- 保留数据集属性。
Available functions
- +，-，log()，等等。
- lead()，lag()
- dense_rank()，min_rank()，percent_rank()，row_number()，cume_dist()，ntile()
- cumsum()，cummean()，cummin()，cummax()，cumany()，cumall()
- na_if()，coalesce()
- if_else()，recode()，case_when()