2009-07-05 73 views
6

我很困惑我的代碼的Scheme風格。計劃編碼風格問題

我應該如果格式爲:

a。

if() 
() 
() 

或b。

if()() 
     () 

或c。

if()()() 

我應該格式條款COND作爲
一個。

cond() 
     () 

或b。

cond 
() 
() 

什麼時候使用單個;評論和一個雙重的;;?

回答

7

Here是Lisp風格指南,here是推薦評論風格。

如果你有一個emacs樣式編輯器,在你的s表達式中輸入C-M-q應該爲你格式化;如果你的換行符是合理的(並且縮進列表的編輯器配置沒有變得太糟糕),它會得到正確格式的代碼。

5

要道格的答案填寫您的具體問題:

(if test 
    then 
    else) 

(cond 
    (test1 exp1) 
    (test2 exp2) 
    (else exp3)) 

或者,長系列表達式conds:

(cond 
    (test1 
    exp1 
    exp2) 
    (else 
    exp3 
    exp4)) 

評論約定是有點寬鬆。當我寫代碼小心,我做這樣的事情:

;;; new section ;;; 
;;; section comments 


(define (f g . x) 
    "docstring goes here" 
    ;; in-function comments 
    (g x)) ; trailing line comment 

; VS ;;使用的確切邊界變化。尤其是,有些人(包括我)不太喜歡尾隨線條評論,而是將;用於功能評論,​​用於部分評論。

+0

請注意,大多數方案沒有「文檔字符串」。 – 2009-07-08 03:53:36