←
PDF 308 / 520 Choosing Names
→
English · PDF 308
Original PDF page 308
中文 · PDF 308

你可以通过参数的唯一前缀来引用参数(例如 mean(x, n = TRUE)),但考虑到可能引起混淆,通常最好避免这样做。

注意,在调用函数时,函数调用中的 = 两侧应留空格,并且逗号后总是留一个空格,逗号前不留(就像普通英语一样)。使用空白字符可以让你更容易浏览函数,找到重要的部分:

# Good average <- mean(feet / 12 + inches, na.rm = TRUE) # Bad average<-mean(feet/12+inches,na.rm=TRUE)

选择名称

参数的名称也很重要。R 并不在乎,但你的代码的读者(包括未来的你!)会在乎。一般来说,你应该倾向于使用更长、更具描述性的名称,但也有一些非常常见、非常简短的名称。值得记住它们:

  • x, y, z:向量。
  • w:权重向量。
  • df:数据框。
  • i, j:数值索引(通常是行和列)。
  • n:长度,或行数。
  • p:列数。

除此之外,可以考虑与现有 R 函数中的参数名称保持一致。例如,使用 na.rm 来确定是否应移除缺失值。

检查值

当你开始编写更多函数时,你最终会到达一个不再确切记得函数如何工作的阶段。此时很容易用无效的输入调用你的函数。为了避免这个问题,将约束条件明确表达出来通常很有用。例如,假设你已经编写了一些用于计算加权汇总统计量的函数: