返回介绍

1.5.1 C 语言的代码注释

发布于 2025-04-11 22:32:50 字数 917 浏览 0 评论 0 收藏 0

想必大家在学习时有过这样的经历:学习文言文时,遇到看不到的句子,就在旁边加上白话文来说明,学习英文时,遇到不会读的单词就用音近的中文文字来标注,学习课文时,每一段都会写出段落大意,并能说出整篇文章的中心思想。

类似地,C 语言的代码注释的作用也是如此。A 同学写出的程序代码,B 同学拿过来可能就看不懂,甚至时间久了,A 同学自己也理解不了。“好记性不如烂笔头”,如果在代码里加上恰当的注释,对于代码交流就相对容易多了,而且即使过了很长的时间,看到注释也自然能回想到当初为何这么写代码。所以,代码注释就是为了更好地理解代码,方便相互交流的一种文字说明。C 语言中的代码注释方式有两种:块注释和行注释。

1.块注释

“第一个 C 程序”中的首行就是一个块注释,它是用“/*”和“*/”所包含的一段(一行或多行)文字。块注释非常灵活,可以出现在程序代码的任何部分,甚至在某一条语句之中。但块注释不允许被嵌套使用,即不能在一个块注释中又出现另一个块注释。例如“/*aa/*bb*/cc*/”,块注释是从“/*”开始,到遇见第一个“*/”结束,所以真正的块注释部分只有“/*aa/*bb*/”,后面的“cc*/”就不是块注释的部分了。

2.行注释

C 语言程序代码中,以“//”开头的部分称为行注释。顾名思义,行注释只能注释一行,从“//”开始,直到该行的末尾,都为注释的部分。如果要使用行注释来注释多行,就得在每一行的行首都使用“//”。

最后,还需要强调两点:①注释只是给人看的,并不会参与编译,也就是说在真正编译的时候这些注释都会被忽略掉。②错误的注释比没有注释更糟糕,注释的内容要做到表述清晰、文词达意,若代码被修改,注释也要及时更新。

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

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

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。
列表为空,暂无数据
    我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。