R语言【base】——table()：使用交叉分类因子来构建每个因子水平组合的计数列联表。

Package base version 4.2.0

---

Parameters

table(...,
      exclude = if (useNA == "no") c(NA, NaN),
      useNA = c("no", "ifany", "always"),
      dnn = list.names(...), deparse.level = 1)

as.table(x, ...)
is.table(x)

## S3 method for class 'table'
as.data.frame(x, row.names = NULL, ...,
              responseName = "Freq", stringsAsFactors = TRUE,
              sep = "", base = list(LETTERS))

参数【...】：一个或多个对象，可以解释为因子（包括数字或字符串），或列表（例如数据框），其组件可以这样解释。（对于 as.table，传递给特定方法的参数；对于 as.data.frame，未使用。）

参数【exclude】：要删除所有参数【...】因子的水平。如果它不包含 NA 且未指定参数【useNA】，则表示参数【useNA】 = “ifany”。有关非因子参数的解释。

参数【useNA】：是否在表中包含 NA 值。可以缩写。

参数【dnn】：要为结果中的维度指定的名称（dimnames names）。

参数【deparse.level】：控制默认参数【dnn】的构造方式。

参数【x】：任意 R 对象，或从 as.data.frame 方法的类 “table” 继承的对象。请注意，对于非表格结构的参数【x】，可以显式调用 as.data.frame.table（x， *） 以 “重塑” 数组。

参数【row.names】：提供数据框行名称的字符向量。

参数【responseName】：用于表条目列的名称通常计数。

参数【stringsAsFactors】：逻辑值。分类因子应该作为因子（默认）还是字符向量返回？

参数【sep，base】：传递给 provideDimnames。

---

Details

如果未提供参数【dnn】，则调用内部函数 list.names 来计算 “dimname names”，如下所示：如果参数【...】是一个具有自己 names() 的列表，这些名称被使用。否则，如果参数【...】被命名，这些名称被使用。对于其余参数，参数【deparse.level】 = 0 给出一个空名称，参数【deparse.level】 = 1 使用提供的参数（如果它是符号），而 参数【deparse.level】= 2 将取消解析参数。

只有当指定了参数【exclude】（即不是默认的）且非空时，表才会潜在地删除因子参数的水平。

参数【useNA】控制表是否包含 NA 值的计数：允许的值对应于 never （“no”），仅当计数为正 （“ifany”） 时，甚至对应于零计数 （“always”）。请注意两种不同种类的 NA 的有点“病理性”的情况，它们根据参数【useNA】和参数【exclude】的不同处理方式不同。

参数【exclude】和参数【useNA】都以“全有或全无”为基础运行。如果要单独控制多路表的维度，请使用 factor 或 addNA 修改每个参数。

类“table”的汇总方法（用于由 table 或 xtabs 创建的对象），它提供基本信息并执行因子独立性的卡方检验（请注意，函数 chisq.test 目前只处理二维表）。

---

Value

table() 返回一个列联表，一个类为 “table” 的对象，一个整数值数组。请注意，与 S 不同，结果始终是一个数组，如果给定一个因子，则为一维数组。

as.table 和 is.table 分别强制执行和测试列联表。

从类 “table” 继承的对象的 as.data.frame 方法可用于将列联表的基于数组的表示形式转换为包含分类因子和相应条目的数据帧（后者作为由参数【responseName】命名的组件）。这是 xtabs 的反面。