方案编码风格问题
我对我的代码的方案风格感到困惑。
我应该将 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 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论
评论(3)
这里是 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).
要填写道格对您的具体问题的回答:
或者,对于具有长系列表达式的条件:
注释约定有点宽松。 当我仔细编写代码时,我会这样做:
但是
;
与;;
用法的确切界限有所不同。 特别是,有些人(包括我)不太喜欢尾随行注释,而是使用;
进行函数内注释,使用;;;
进行部分注释。To fill in Doug's answer for your specific questions:
Or, for conds with long series of expressions:
Comment conventions are a little looser. When I am writing careful code, I do something like this:
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.看看 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.