《C++入门经典(第5版•修订版)》——2.3 注释

简介:

本节书摘来自异步社区出版社《C++入门经典(第5版•修订版)》一书中的第2章,第2.3节,作者:【美】Jesse Liberty , Rogers Cadenhead,更多章节内容可以访问云栖社区“异步社区”公众号查看。

2.3 注释

C++入门经典(第5版•修订版)
在您编写程序时,每行源代码的功能显而易见,但随着时间的流逝,再回过头来修复程序Bug或添加新功能时,常常会发现对自己以前做的工作感到一头雾水。

为避免这种困境,并帮助他人理解您编写的代码,可在源代码中添加注释。注释是阐述程序做什么的文本,编译器对其置之不理,因此只能给阅读代码的人带来好处。

在C++中,有两种类型的注释。单行注释以两个斜杆(//)打头,导致编译器忽略从这里开始到行尾的全部内容,下面是一个例子:
image

多行注释以斜杠和星号(/)打头,并以星号和斜杆(/)结尾。/和/之间的所有内容都是注释,哪怕它们占据多行。如果程序中不存在与/配套的/,编译器将视之为错误。下面是一个多行注释:

image

在上述注释中,为提高可读性,让文本左对齐,但并非必须这样,因为编译器忽略//之间的所有内容。在这里,可包含任何内容:杂货清单、情诗、从未告诉过别人的秘密等。

警告:
关于多行注释,需要牢记的一个重点是,不能将其嵌套。如果您使用/开始注释,并在几行后又使用了一个/ ,则编译器见到第一个/后,将认为多行注释到此结束,这样第二个/将导致编译器错误。大多数C++编辑器都以不同的颜色显示注释,让注释的开始和结束位置非常清晰。
在稍后您将创建的项目中,包含了这两种类型的注释。请在程序中添加大量注释,您为解释代码的功能而在编写注释上花的时间越多,几周、几月甚至几年后,代码就越容易理解。

相关文章
|
30天前
|
算法 Unix 程序员
【C/C++ 基本知识 注释规范】C/C++中注释方式以及规范
【C/C++ 基本知识 注释规范】C/C++中注释方式以及规范
22 0
|
1月前
|
C++
C++注释
C++注释
8 0
|
3月前
|
存储 C++
第一章:C++中的注释、变量和数据类型、运算符
第一章:C++中的注释、变量和数据类型、运算符
24 0
|
6月前
|
编译器 C++
C++入门篇之 注释语法什么写
C++入门篇之 注释语法什么写
|
10月前
|
算法 C++
C++(注释语句)
C++(注释语句)
|
10月前
|
编译器 C++
C++ 如何去注释语法解析
C++ 如何去注释语法解析
|
11月前
|
编译器 C++
C++ 注释
【摘要】 C++ 注释程序的注释是解释性语句,您可以在 C++ 代码中包含注释,这将提高源代码的可读性。所有的编程语言都允许某种形式的注释。C++ 支持单行注释和多行注释。注释中的所有字符会被 C++ 编译器忽略。C++ 注释一般有两种:// - 一般用于单行注释。/* ... */ - 一般用于多行注释。注释以 // 开始,直到行末为止。例如:实例#include <iostream>using n...
|
11月前
|
编译器 C++
C++ 基础篇c++注释语法解析
程序的注释是解释性语句,您可以在 C++ 代码中包含注释,这将提高源代码的可读性。所有的编程语言都允许某种形式的注释。
|
编译器 C++
C++入门篇之 注释语法什么写
C++入门篇之 注释语法什么写
88 0
C++入门篇之 注释语法什么写
|
算法 C++
“递归算法”求数组最大值(含详细注释解析C++)
“递归算法”求数组最大值(含详细注释解析C++)
184 0
“递归算法”求数组最大值(含详细注释解析C++)