【C语言基础篇】注释

一、注释的简介

注释就是对代码的解释和说明，其目的是让人们能够更加轻松地了解代码。注释是编写程序时，写程序的人给一个语句、程序段、函数等的解释或提示，能提高程序代码的可读性。

注释只是为了提高可读性，不会被计算机编译。注释是对代码的说明，编译器会忽略注释，也就是说，注释对实际代码没有影响。

C语言注释有三种方式 ，分别是单行注释，多行注释和条件编译注释，其中前两种在初级编程较为常见

1.单行注释

C99标准引入的注释方式

将注释放在双斜杠 // 后面，从双斜杠到行尾都属于注释。

// 注释内容

#include<stdio.h>
int main()
{
  //printf("hello\n"); 这是一整行注释
  printf("world\n");//双斜杠后面为注释
  return 0;
}

2.多行注释（块注释）

将注释放在 /*...*/ 之间，内部可以分多行。

/*

注释内容

注释内容

注释内容

*/

#include<stdio.h>
int main()
{
  /*
  printf("hello\n"); 
  printf("world\n");
  这是多行注释
  */
  return 0;
}

这种注释也可以插入在行内

比如下面这个例子，注释来对函数参数进行说明，跟在它后⾯的代码依然会有效执行。

int print(int arr, int sz/*数组元素*/，char a);

/**/ 的这个注释不支持嵌套注释

/* 开始注释后，遇到第⼀个 */ 就认为注释结束了。

在某些编译器中，如果/* */没有成对匹配还会报错

#include<stdio.h>
int main()
{
  /*
  printf("hello");
  printf("world");/*注释到此结束*/
  printf("\n");
  */
  return 0;
}

3.条件编译注释

#if 0  配合  #endif  可实现代码的成块注释。

条件编译指令#if后面跟整型常量表达式。如果表达式为非零，则表达式为真，编译器条件执行代码块；反之，编译器忽略代码块。

# if 0

注释内容

# endif

下面这个例子中，第一个代码块被忽略，第二个代码块执行，输出abc；

如果想要换成执行第一个代码块，输出ABC，则只需将“1”和“0”位置互换

#include<stdio.h>
int main()
{
#if 0
  printf("ABC\n");
#endif
 
#if 1
  printf("abc\n");
#endif
  return 0;
}

二、注释的注意事项

注释在双引号内失效

不管是哪⼀种注释，都不能放在双引号里面。

双引号里面的注释符号，会成为字符串的⼀部分，解释为普通符号，失去注释作用。

#include<stdio.h>
int main()
{
  printf("// hello /* world */ \n");
  return 0;
}