如何在python代码中包装和对齐注释
内容导读
互联网集市收集整理的这篇技术教程文章主要介绍了如何在python代码中包装和对齐注释,小编现在分享给大家,供广大互联网技能从业者学习和参考。文章包含1818字,纯文字阅读大概需要3分钟。
内容图文
![如何在python代码中包装和对齐注释](/upload/InfoBanner/zyjiaocheng/762/7ea73fabcc804feabbefc839367e6060.jpg)
我试图让我的python代码看起来更具可读性.我读了style guide,但我不知道如何得到这样的东西
x = foo(x); # compute the value of the next prime number
# that is larger than x (foo is a really bad
# choice for this function's name)
或这个
x = x + 1 # Compensate for border
some other code # some other comment
你如何包装评论并将它们对齐?你不只是输入一堆空间,对吗?如果我编辑了代码,我是否必须手动重新排列注释?
我正在使用emacs作为我的编辑器.
解决方法:
我认为你根本不想要这个. Lattyware已经解释了第二种情况,但让我们来看看第一种情况:
x = foo(x); # compute the value of the next prime number
# that is larger than x (foo is a really bad
# choice for this function's name)
太长而无法嵌入的注释可以转换为代码上方的块注释,如下所示:
# compute the value of the next prime number that is larger than
# x (foo is a really bad choice for this function's name)
x = foo(x);
这似乎比右对齐的评论更具可读性.它还为您提供更多空间.使用emacs肯定更容易(只需键入整个内容和meta-Q).并且,在PEP 8中引用Inline Comments:
Use inline comments sparingly.
An inline comment is a comment on the same line as a statement.
这是内联注释的样式指南的开始,它强烈地暗示如果你想要写的数量超过你可以放在同一行上,你应该使用块注释.
另外,在我们谈论PEP 8时:
>“评论应该是完整的句子.”您的第一条评论需要期间. (是的,它也说“如果评论很短,最后的句号可以省略”,但你有一个3行2句的评论,所以这里不适用.)
>“如果评论是短语或句子,则其第一个单词应该大写”.所以,大写“Compute”(但不是“foo”,因为那是一个标识符).
>不要添加功能名称不好的注释,只需重命名该功能即可.
>摆脱那个分号.
所以:
# Compute the value of the next prime number that is larger than x.
x = next_larger_prime(x)
但是一旦你这样做了,你甚至不需要评论.
事实上,这很常见.当您发现自己想知道如何打破评论的样式指南时,您可能应该通过询问如何重新组织代码以使其不需要所有这些注释.这并不总是可能,但通常值得至少尝试.
内容总结
以上是互联网集市为您收集整理的如何在python代码中包装和对齐注释全部内容,希望文章能够帮你解决如何在python代码中包装和对齐注释所遇到的程序开发问题。 如果觉得互联网集市技术教程内容还不错,欢迎将互联网集市网站推荐给程序员好友。
内容备注
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 gblab@vip.qq.com 举报,一经查实,本站将立刻删除。
内容手机端
扫描二维码推送至手机访问。