1.3.3 合理注释
在C语言代码中添加注释，可用来对程序进行分析说明及提示需注意的问题。注释不会影响程序的执行，在C语言中用"/* */"来表示。注释虽然有助于代码的理解，但是也不能滥用。
注释建议如下：
（1）一些简单的语句不用加注释，如下面的代码注释则显的多余。
- i--; /*i减1*/
（2）注释应与源代码相近，不可太远，放在代码的左边、右边、上边都可以。
（3）注释应适量，不可太多，毕竟注释只起辅助的作用。
（4）修改代码时，应修改注释，保存代码和注释的一致性。
（5）注释应尽可能的准确、简洁。
（6）对于结构化的程序，应在该结构的开头或末尾加注释，便于理解和阅读。
【范例1.2】用C语言打印出简单的C字母。
分析：可以先在纸上画出图形，利用stdio.h头文件中的printf()函数进行分行输出，最终在屏幕上输出一个字母C。
范例1.2 代码实现
- 01 #include <stdio.h>
- 02 void main() /*主函数入口，void表示该函数没有返回值*/
- 03 {
- 04 printf("****\n"); /*利用printf()函数进行相应的输出*/
- 05 printf("*\n");
- 06 printf("*\n");
- 07 printf("****\n");
- 08 }
【代码分析】本例用printf()函数进行了简单的输出，详细代码分析如下：
第4～7行利用printf()函数进行相应的输出并换行来打印字母C，其中printf()函数中的"\n"表示换行，输出的内容需要用引号包围起来。
【运行结果】该程序的执行结果如图1-13所示。
【范例1.3】从键盘中输入一个数，并将其输出至屏幕。
分析：利用stdio.h头文件中的scanf()函数实现数字的输入，再利用printf()函数输出该数。
 |
| （点击查看大图）图1-13 范例1.2结果图 |
范例1.3 代码实现
- 01 #include <stdio.h>
- 02 void main()
- 03 {
- 04 int a; /*定义一个整型变量a*/
- 05 printf("input number:"); /*利用printf()函数输出提示语句*/
- 06 scanf("%d",&a); /*通过scanf()函数从键盘获取数据*/
- 07 printf("The number is:%d\n",a); /*通过printf()函数输出变量a的值*/
- 08 }
【代码分析】本例利用scanf()函数和printf()函数分别进行数据的输入输出，详细代码分析如下：
第3行定义一个整型变量a用来保存输入的数字，这种数据类型将会在本书后面的章节讲解到。
第5行调用scanf()函数实现数字从键盘输入，将输入的数字保存至相应的变量，即变量a中。
【运行结果】该程序的执行结果如图1-14所示。
 |
| 图1-14 范例1.3结果图 |
注意：scanf()函数中的"&"一定要有，否则输入的数字将不能保存至相应的变量中，程序运行结果会出错。