首页 > 其他 > 详细

注释的最佳位置

时间:2019-05-11 22:05:27      阅读:107      评论:0      收藏:0      [点我收藏+]

对代码的注释应放在其上方相邻位置,不可放在下面。

对数据结构的注释应放在其上方相邻位置,不可放在下面。

对结构中的每个域的注释应放在此域的右方。

同一结构中不同域的注释要对齐。

变量、常量的注释应放在其上方相邻位置或右方。

边写代码边注释,修改代码同时修改相应的注释,以保证注释与代码的一致性。
在必要的地方注释,注释量要适中。注释的内容要清楚、明了,含义准确,防止注释二义性。
保持注释与其描述的代码相邻,即注释的就近原则。

简而言之,注释要写在上面或右面。

注释的最佳位置

原文:https://www.cnblogs.com/qobin/p/10850075.html

(0)
(0)
   
举报
评论 一句话评论(0
关于我们 - 联系我们 - 留言反馈 - 联系我们:wmxa8@hotmail.com
© 2014 bubuko.com 版权所有
打开技术之扣,分享程序人生!