方案编码风格问题

发布于 2024-07-26 08:25:58 字数 383 浏览 4 评论 0原文

我对我的代码的方案风格感到困惑。

我应该将 if 格式格式化为

if()
  ()
  ()

或 b.

  if () ()
        ()

或c。

if () () ()

我应该将 cond 子句格式化为
A。

  cond ()
       ()

或 b.

cond
()
()

我什么时候使用单个 ; 评论和双重 ;;?

I am confused about the Scheme style for my code.

Should I format if forms as:

a.

if()
  ()
  ()

or b.

  if () ()
        ()

or c.

if () () ()

Should I format cond clauses as
a.

  cond ()
       ()

or b.

cond
()
()

When do I use a single ; to comment and a double ;;?

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

评论(3

那支青花 2024-08-02 08:25:58

这里是 Lisp 风格指南,这里是推荐的评论风格。

如果您有 emacs 样式编辑器,则在 s 表达式中输入 CMq 应该会为您设置格式; 如果您的换行符合理(并且缩进列表的编辑器配置没有被修改得太严重),它将为您提供正确格式的代码。

Here is a Lisp style guide, and here is a recommended commenting style.

If you have an emacs style editor, typing C-M-q within your s-expression should format it for you; it will get you correctly formatted code if your line breaks are reasonable (and editor configuration for indent-alist hasn't been munged too badly).

时光倒影 2024-08-02 08:25:58

要填写道格对您的具体问题的回答:

(if test
    then
    else)

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

或者,对于具有长系列表达式的条件:

(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

但是 ;;; 用法的确切界限有所不同。 特别是,有些人(包括我)不太喜欢尾随行注释,而是使用 ; 进行函数内注释,使用 ;;; 进行部分注释。

To fill in Doug's answer for your specific questions:

(if test
    then
    else)

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

Or, for conds with long series of expressions:

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

Comment conventions are a little looser. When I am writing careful code, I do something like this:

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


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

But the exact boundaries for ; vs ;; usage vary. In particular, some people (including me) do not much like trailing line comments and will instead use ; for in-function comments and ;;; for section comments.

何其悲哀 2024-08-02 08:25:58

看看 Peter Norvig 的 “Good Lisp 编程风格教程”,你就会找到答案任何Scheme/Lisp书中的特定问题。

Have a look at Peter Norvig's "Tutorial on Good Lisp Programming Style" though you would have found the answer to your particular question in any Scheme/Lisp book.

~没有更多了~
我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
原文