google的R语言编码规范.pdf

C:\Users\Administrator\Desktop\来自google的R语言编码规范.r 2014年9月25 日 10:57 来自 Google 的 R 语言编码风格指南 R 语言是一门主要用于统计计算和绘图的高级编程语言. 这份 R 语言编码风格指南旨在让我们的 R 代码更容易阅读、分享和检查. 以下规则系与 Google 的 R 用户群体协同设计而成. 概要: R编码风格约定 文件命名: 以 .R (大写) 结尾 标识符命名: , FunctionName, kConstantName 单行长度: 不超过 80 个字符 缩进: 两个空格, 不使用制表符 空白 花括号: 前括号不折行写, 后括号独占一行 赋值符号: 使用 - , 而非 = 分号: 不要用 总体布局和顺序 注释准则: 所有注释以 # 开始, 后接一个空格; 行内注释需要在 # 前加两个空格 函数的定义和调用 函数文档 示例函数 TODO 书写风格: TODO(您的用户名) 概要: R语言使用规则 attach: 避免使用 函数: 错误 (error) 应当使用 stop() 抛出 对象和方法: 尽可能避免使用 S4 对象和方法; 永远不要混用 S3 和 S4 表示和命名 文件命名 文件名应以 .R (大写) 结尾, 文件名本身要有意义. 正例: predict_ad_revenue.R 反例: foo.R 标识符命名 在标识符中不要使用下划线 ( _ ) 或连字符 ( - ). 标识符应根据如下惯例命名. 变量名应使用点 (.) 分隔所有的小写字母或单词; 函数名首字母大写, 不用点分隔 (所含单词首字母大写); 常数命名规则同函数, 但需使用一个 k 开头. 正例: avg.clicks 反例: avg_Clicks , avgClicks FunctionName 正例: CalculateAvgClicks 反例: calculate_avg_clicks , calculateAvgClicks 函数命名应为动词或动词性短语. 例外: 当创建一个含类 (class) 属性的对象时, 函数名 (也是constructor) 和类名 (class) 应当匹配 (例如, lm) . kConstantName 语法 单行长度 最大单行长度为 80 个字符. 缩进 使用两个空格来缩进代码. 永远不要使用制表符或混合使用二者. -1- C:\Users\Administrator\Desktop\来自google的R语言编码规范.r 2014年9月25 日 10:57 例外: 当括号内发生折行时, 所折行与括号内的第一个字符对齐. 空白 在所有二元操作符 (=, + , -, - , 等等) 的两侧加上空格. 例外: 在函数调用中传递参数时 = 两边的空格可加可不加. 不可在逗号前加空格, 逗号后总须加空格. 正例: tabPrior - table(df[df$daysFromOpt 0, campaignid]) total - sum(x[, 1]) total - sum(x[1, ]) 反例: tabPrior - table(df[df$daysFromOpt 0, campaignid]) # 在 两侧需要增加空格 tabPrior - table(df[df$daysFromOpt 0,campaignid]) # 逗号后需要一个空格 tabPrior- table(df[df$daysFromOpt 0, campaignid]) # 在 - 前需要一个空格 tabPrior-table(df[df$daysFromOpt 0, campaignid]) # 在 - 两侧需要增加空格 total - sum(x[,1]) # 逗号后需要一个空格 total - sum(x[ ,1]) # 逗号后需要一个空格, 而非逗号之前 在前括号前加一个空格, 函数调用时除外. 正例: if (debug) 反例: if (debug) 多加空格 (即, 在行内使用多于一个空格) 也是可以的, 如果这样做能够改善等号或箭头 (-) 的对齐效果. plo