R語(yǔ)言代碼規(guī)范

編程的代碼規(guī)范目的是使我們的R代碼更容易閱讀、分享和驗(yàn)證菠红,下述是一些約定俗成的代碼規(guī)范:

1.0 文件名

對(duì)于R file名字的命名尚骄,一般采用一些有意義的名字來(lái)命名,不要有特殊字符和空格毙死,但是要注意大小寫(特別是windowws系統(tǒng)是不管大小寫的)燎潮,所以最好就小寫就行了;R代碼就放在.R文件中扼倘,而R數(shù)據(jù)文件則放在.RData文件中确封。我一般不用下劃線分割文件名,而是使用大小寫交替的方式

GOOD: predict_ad_revenue.R; PredictAdRevenue.R
BAD: foo.R

2.0 標(biāo)識(shí)符(Identifiers)

不要使用下劃線(_)或連字符(-)標(biāo)識(shí)符再菊。標(biāo)識(shí)符應(yīng)按照以下命名約定爪喘。變量名的首選形式都是小寫字母和單詞分開用點(diǎn)(variable.name),但也接受variableName;函數(shù)名使用首字母大寫而不用點(diǎn)(FunctionName);

variable.name is preferred, variableName is accepted
GOOD: avg.clicks
OK: avgClicks
BAD: avg_Clicks

FunctionName
GOOD: CalculateAvgClicks
BAD: calculate_avg_clicks , calculateAvgClicks
Make function names verbs.
Exception: When creating a classed object, the function name

3.0 間距(Spacing)

當(dāng)使用所有二進(jìn)制運(yùn)算符(如=,+,-,<,等)在兩端空格。例外:當(dāng)符號(hào) = 是函數(shù)調(diào)用時(shí)的傳遞參數(shù)周圍不用空格隔開纠拔。
不要在符號(hào)“秉剑,”前空格隔開,但需要在“绿语,”后添加空格
good style

tab.prior <- table(df[df$days.from.opt < 0, "campaign.id"]) 
total <- sum(x[, 1]) 
total <- sum(x[1, ])123

bad style

tab.prior <- table(df[df$days.from.opt<0, "campaign.id"])  # Needs spaces around '<' 
tab.prior <- table(df[df$days.from.opt < 0,"campaign.id"])  # Needs a space after the comma
tab.prior<- table(df[df$days.from.opt < 0, "campaign.id"])  # Needs a space before <
tab.prior<-table(df[df$days.from.opt < 0, "campaign.id"])  # Needs spaces around <
total <- sum(x[,1])  # Needs a space after the comma 
total <- sum(x[ ,1])  # Needs a space after the comma, not before123456

4.0 花括號(hào)(Curly braces)

前括號(hào)永遠(yuǎn)不應(yīng)該獨(dú)占一行; 后括號(hào)應(yīng)當(dāng)總是獨(dú)占一行. 在代碼塊只含單個(gè)語(yǔ)句時(shí)可省略花括號(hào)

if (is.null(ylim)) {
  ylim <- c(0, 0.06)
}

5.0 賦值

使用<-進(jìn)行賦值, 不用=賦值.

6.0 注釋

整行注釋應(yīng)以#后接一個(gè)空格開始秃症,行內(nèi)短注釋應(yīng)在代碼后接兩個(gè)空格, #, 再接一個(gè)空格。

# Create histogram of frequency of campaigns by pct budget spent.
hist(df$pct.spent,
     breaks = "scott",  # method for choosing number of buckets
     main   = "Histogram: fraction budget spent by campaignid",
     xlab   = "Fraction of budget spent",
     ylab   = "Frequency (count of campaignids)")

7.0 函數(shù)的定義和調(diào)用

函數(shù)定義應(yīng)首先列出無(wú)默認(rèn)值的參數(shù), 然后再列出有默認(rèn)值的參數(shù)吕粹。函數(shù)定義和函數(shù)調(diào)用中, 允許每行寫多個(gè)參數(shù); 折行只允許在賦值語(yǔ)句外進(jìn)行种柑。

8.0 分號(hào)

不要以分號(hào)結(jié)束一行, 也不要利用分號(hào)在同一行放多于一個(gè)命令. (分號(hào)是毫無(wú)必要的, 并且為了與其他Google編碼風(fēng)格指南保持一致, 此處同樣略去. )(分號(hào)作為語(yǔ)句結(jié)束標(biāo)識(shí),雖然不規(guī)范匹耕,但是在縮短文檔長(zhǎng)度的時(shí)候我會(huì)選擇使用...)

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末聚请,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌驶赏,老刑警劉巖炸卑,帶你破解...
    沈念sama閱讀 221,635評(píng)論 6 515
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異煤傍,居然都是意外死亡盖文,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,543評(píng)論 3 399
  • 文/潘曉璐 我一進(jìn)店門蚯姆,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)五续,“玉大人,你說(shuō)我怎么就攤上這事龄恋「砑荩” “怎么了?”我有些...
    開封第一講書人閱讀 168,083評(píng)論 0 360
  • 文/不壞的土叔 我叫張陵郭毕,是天一觀的道長(zhǎng)它碎。 經(jīng)常有香客問我,道長(zhǎng)显押,這世上最難降的妖魔是什么扳肛? 我笑而不...
    開封第一講書人閱讀 59,640評(píng)論 1 296
  • 正文 為了忘掉前任,我火速辦了婚禮煮落,結(jié)果婚禮上敞峭,老公的妹妹穿的比我還像新娘。我一直安慰自己蝉仇,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 68,640評(píng)論 6 397
  • 文/花漫 我一把揭開白布殖蚕。 她就那樣靜靜地躺著轿衔,像睡著了一般。 火紅的嫁衣襯著肌膚如雪睦疫。 梳的紋絲不亂的頭發(fā)上害驹,一...
    開封第一講書人閱讀 52,262評(píng)論 1 308
  • 那天,我揣著相機(jī)與錄音蛤育,去河邊找鬼宛官。 笑死,一個(gè)胖子當(dāng)著我的面吹牛瓦糕,可吹牛的內(nèi)容都是我干的底洗。 我是一名探鬼主播,決...
    沈念sama閱讀 40,833評(píng)論 3 421
  • 文/蒼蘭香墨 我猛地睜開眼咕娄,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼亥揖!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 39,736評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤费变,失蹤者是張志新(化名)和其女友劉穎摧扇,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體挚歧,經(jīng)...
    沈念sama閱讀 46,280評(píng)論 1 319
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡扛稽,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,369評(píng)論 3 340
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了滑负。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片在张。...
    茶點(diǎn)故事閱讀 40,503評(píng)論 1 352
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖橙困,靈堂內(nèi)的尸體忽然破棺而出瞧掺,到底是詐尸還是另有隱情,我是刑警寧澤凡傅,帶...
    沈念sama閱讀 36,185評(píng)論 5 350
  • 正文 年R本政府宣布辟狈,位于F島的核電站,受9級(jí)特大地震影響夏跷,放射性物質(zhì)發(fā)生泄漏哼转。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,870評(píng)論 3 333
  • 文/蒙蒙 一槽华、第九天 我趴在偏房一處隱蔽的房頂上張望壹蔓。 院中可真熱鬧,春花似錦猫态、人聲如沸佣蓉。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,340評(píng)論 0 24
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)勇凭。三九已至,卻和暖如春义辕,著一層夾襖步出監(jiān)牢的瞬間虾标,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,460評(píng)論 1 272
  • 我被黑心中介騙來(lái)泰國(guó)打工灌砖, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留璧函,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 48,909評(píng)論 3 376
  • 正文 我出身青樓基显,卻偏偏與公主長(zhǎng)得像蘸吓,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子续镇,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,512評(píng)論 2 359

推薦閱讀更多精彩內(nèi)容