读c语言深度剖析 -- 符号 注释符号

标准C语言的基本符号
，逗号 >右尖括号 . 圆点 !感叹号 ；分号 | 竖线 ：冒号 /斜杠 ？问号 \反斜杠
’单引号 ~波折号 “双引号 #井号 ( 左圆括号 )右圆括号 [ 左方括号 ]右方括号
{左大括号 }右大括号 % 百分号 &and（与） ^ xor（异或） *乘号 -减号 =等于号
<左尖括号 +加号

注释符号
几个似非而是的注释问题
C语言的注释可以出现在C语言代码的任何地方。这句话是不对的、
1 int/*...*/i; 编译器的确会将注释剔除，但不是简单的剔除，而是用空格代替原来的注释
2 char*s="abcdefgh //hijklmn";我们知道双引号引起来的是字符串常量，那双斜杠也不例外
3 //Isita \
validcomment? 这是一条合法的注释，因为\是一个接续符
4 //in/*…*/ti;
5 /*这是*/#/*一条*/define/*合法的*/ID/*预处理*/replacement/*指*/list/*令*/
6 y=x/*p 报错 这个表达式其实只是表示把x的值赋给y，/*后面的内容都当作注释。但是，由于没有找到*/，所以提示出错。也就是说只要斜
杠 （/）和星号（*）之间没有空格，都会被当作注释的开始。这一点一定要注意。 修改为y=x/ *p或者y= x/(*p)
出色注释的基本要求
1 注释应当准确、易懂，防止有二义性。错误的注释不但无益反而有害。
2 边写代码边注释，修改代码同时修改相应的注释，以保证注释与代码的一致性。不再有用的注释要及时删除。
3 注释是对代码的“提示”，而不是文档。程序中的注释应当简单明了，注释太多了会让人眼花缭乱。
4 一目了然的语句不加注释。 例如：i++;/*i加1*/多余的注释
5 对于全局数据（全局变量、常量定义等）必须要加注释。
6 注释采用英文，尽量避免在注释中使用缩写，特别是不常用缩写。因为不一定所有的编译器都能显示中文，别人打开你的代码，
你的注释 也许是一团乱码。还有，你的代码不一定是懂中文的人阅读。
7 注释的位置应与被描述的代码相邻，可以与语句在同一行，也可以在上行，但不可放在下方。同一结构中不同域的注释要对齐。
8 当代码比较长，特别是有多重嵌套时，应当在一些段落的结束处加注释，便于阅读。
9 注释的缩进要与代码的缩进一致。
10 注释代码段时应注重“为何做（why）”，而不是“怎么做（how）”。
说明怎么做的注释一般停留在编程语言的层次，而不是为了说明问题。尽力阐述“怎么做”的注释一般没有告诉我们操作的意图，
而指明“怎么做”的注释通常是冗余的。
11 数值的单位一定要注释。注释应该说明某数值的单位到底是什么意思。比如：
关于长度的必须说明单位是毫米，米，还是千米等；关于时间的必须说明单位是时，分，秒，还是毫秒等。
12 对变量的范围给出注释。
13 对一系列的数字编号给出注释，尤其在编写底层驱动程序的时候（比如管脚编号）。
14 对于函数的入口出口数据给出注释。关于函数的注释在函数那章有更详细的讨论。
接续符和转义符
C语言里以反斜杠（\）表示断行。编译器会将反斜杠剔除掉，跟在反斜杠后面的字符自动接续到前一行。
但是注意：反斜杠之后不能有空格，反斜杠的下一行之前也不能有空格。(不太准确)
//Isita \
validcomment? 前边可以有空格

#def\
ine MAC\ 前边不可以有define
RO这是一条合法的\ 前边可以有
宏定义
cha\
r* ch="这是一个合法的\\ 前边不可以有 char
n字符串"; 前边可以有
综上可知当下一行的字符与上一行联系很密切的时候(关键字等等)下一行前边不可有空格
而紧随\ 后是肯定不可以有空格
再例
//这是一条合法的\
单行注释 前边可以有空格
/\
/这是一条合法的单行注释 前边不可以有因为 //注释符不能分开

注释小故事一则
安息吧，路德维希.凡.贝多芬
在《CodeComplete》这本书中，作者记录了这样一个故事：
有位负责维护的程序员半夜被叫起来，去修复一个出了问题的程序。但是程序的原作
者已经离职，没有办法联系上他。这个程序员从未接触过这个程序。在仔细检查所有的说明
后，他只发现了一条注释，如下：
MOVAX723h;R.I.P.L.V.B.
这个维护程序员通宵研究这个程序，还是对注释百思不得其解。虽然最后他还是把程
序的问题成功排除了，但这个神秘的注释让他耿耿于怀。说明一点：汇编程序的注释是以分
号开头。
几个月后，这名程序员在一个会议上遇到了注释的原作者。经过请教后，才明白这条
注释的意思：安息吧，路德维希.凡.贝多芬（Restinpeace,LudwigVanNeethoven）。贝多芬于
1827年逝世，而1827的十六进制正是723。这真是让人哭笑不得！