在c程序中,注释语句只能位于一条语句的后面吗

错误,在C语言中注释部分对程序的运行结果不产生任何影响,它可以出现在程序的任何位置。在C语言中有两种注释方式:一种是以“/*”开始、以“*/”结束的块注释;一种是以“//”开始、以换行符结束的单行注释。

在c程序中,注释语句只能位于一条语句的后面吗

本文操作环境:windows10系统、c11、thinkpad t480电脑。

相关推荐:C语言视频教程

C语言中的注释

在编写C语言源代码时,应该多使用注释,这样有助于对代码的理解。在C语言中有两种注释方式:

一种是以/*开始、以*/结束的块注释(block comment);

另一种是以//开始、以换行符结束的单行注释(line comment)。

可以使用/*和*/分隔符来标注一行内的注释,也可以标注多行的注释。例如,在下列的函数原型中,省略号的意思是 open() 函数有第三个参数,它是可选参数。注释解释了这个可选参数的用法:

int open( const char *name, int mode, … /* int permissions */ );

可以使用//插入整行的注释,或者将源代码写成两列分栏的格式,程序在左列,注释在右列:

const double pi = 3.1415926536;       // pi是—个常量

在 C99 标准中,单行注释正式加入C语言,但是大部分编译器在 C99 之前就已经开始支持这种用法。有时候,其被称作“C++风格”的注释,但实际上,其源自于C的前身 BCPL。

注释的位置

在C语言中注释部分对程序的运行结果不产生任何影响,它可以出现在程序的任何位置。

示例:

int/*....*/i;                                   //正确char* s="abcdefgh   //hijklmn";                  //正确in/*...*/ti;                                    //错误注释会被空格替换//注意:             /*...*/不能嵌套 ,/*总是与离他最近的*/匹配 y=x/*p           //       该语句由于没有找到*/ 会报错 //要实现以上功能  可以用y=x/(*p)或y=x/ *p代替

注释规范

2-1:一般情况下,源程序有效注释量必须在20%以上。

说明:注释的原则是有助于对程序的阅读理解,在该加的地方都加了,注释不宜太多也不能太少,注释语言必须准确、易懂、简洁。

2-2:文件头部应进行注释,注释必须列出:版权说明、版本号、生成日期、作者、内容、功能、修改日志等。

示例:下面这段头文件的头注释比较标准,当然,并不局限于此格式,但上述信息建议要包含在内。

/*****************************************************************************Copyright: 1988-1999, Huawei Tech. Co., Ltd.File name: 文件名Description: 用于详细说明此程序文件完成的主要功能,与其他模块或函数的接口,输出值、取值范围、含义及参数间的控制、顺序、独立或依赖等关系Author: 作者Version: 版本Date: 完成日期History: 修改历史记录列表, 每条修改记录应包括修改日期、修改者及修改内容简述。*****************************************************************************/

2-3:函数头部应进行注释,列出:函数的目的/功能、输入参数、输出参数、返回值、调用关系(函数、表)等。

示例:下面这段函数的注释比较标准,当然,并不局限于此格式,但上述信息建议要包含在内。

/*************************************************Function: // 函数名称Description: // 函数功能、性能等的描述Calls: // 被本函数调用的函数清单Called By: // 调用本函数的函数清单Table Accessed: // 被访问的表(此项仅对于牵扯到数据库操作的程序)Table Updated: // 被修改的表(此项仅对于牵扯到数据库操作的程序)Input: // 输入参数说明,包括每个参数的作// 用、取值说明及参数间关系。Output: // 对输出参数的说明。Return: // 函数返回值的说明Others: // 其它说明********************************************/

2-4:边写代码边注释,修改代码同时修改相应的注释,以保证注释与代码的一致性。不再有用的注释要删除。

2-5:注释的内容要清楚、明了,含义准确,防止注释二义性。说明:错误的注释不但无益反而有害。

2-6:注释应与其描述的代码相近,对代码的注释应放在其上方或右方(对单条语句的注释)相邻位置,不可放在下面,如放于上方则需与其上面的代码用空行隔开。

示例:如下例子不符合规范。

例1:

/* get replicate sub system index and net indicator */repssn_ind = ssn_data[index].repssn_index;repssn_ni = ssn_data[index].ni;

例2:

repssn_ind = ssn_data[index].repssn_index;repssn_ni = ssn_data[index].ni;/* get replicate sub system index and net indicator */

应如下书写

/* get replicate sub system index and net indicator */repssn_ind = ssn_data[index].repssn_index;repssn_ni = ssn_data[index].ni;

2-7:对于所有有物理含义的变量、常量,如果其命名不是充分自注释的,在声明时都必须加以注释,说明其物理含义。变量、常量、宏的注释应放在其上方相邻位置或右方。

示例:

/* active statistic task number */#define MAX_ACT_TASK_NUMBER 1000#define MAX_ACT_TASK_NUMBER 1000 /* active statistic task number */

2-8:数据结构声明(包括数组、结构、类、枚举等),如果其命名不是充分自注释的,必须加以注释。对数据结构的注释应放在其上方相邻位置,不可放在下面;对结构中的每个域的注释放在此域的右方。

示例:可按如下形式说明枚举/数据/联合结构。

/* sccp interface with sccp user primitive message name */enum SCCP_USER_PRIMITIVE{N_UNITDATA_IND, /* sccp notify sccp user unit data come */N_NOTICE_IND, /* sccp notify user the No.7 network can not *//* transmission this message */N_UNITDATA_REQ, /* sccp user’s unit data transmission request */};

2-9:全局变量要有较详细的注释,包括对其功能、取值范围、哪些函数或过程存取它以及存取时注意事项等的说明。

示例:

/* The ErrorCode when SCCP translate *//* Global Title failure, as follows */ // 变量作用、含义/* 0 - SUCCESS 1 - GT Table error *//* 2 - GT error Others - no use */ // 变量取值范围/* only function SCCPTranslate() in *//* this modual can modify it, and other *//* module can visit it through call *//* the function GetGTTransErrorCode() */ // 使用方法BYTE g_GTTranErrorCode;

2-10:注释与所描述内容进行同样的缩排。

说明:可使程序排版整齐,并方便注释的阅读与理解。示例:如下例子,排版不整齐,阅读稍感不方便。

void example_fun( void ){/* code one comments */CodeBlock One/* code two comments */CodeBlock Two}

应改为如下布局。

void example_fun( void ){/* code one comments */CodeBlock One/* code two comments */CodeBlock Two}

2-11:避免在一行代码或表达式的中间插入注释。

说明:除非必要,不应在代码或表达中间插入注释,否则容易使代码可理解性变差。

2-12:通过对函数或过程、变量、结构等正确的命名以及合理地组织代码的结构,使代码成为自注释的。

说明:清晰准确的函数、变量等的命名,可增加代码可读性,并减少不必要的注释。

2-13:在代码的功能、意图层次上进行注释,提供有用、额外的信息。

说明:注释的目的是解释代码的目的、功能和采用的方法,提供代码以外的信息,帮助读者理解代码,防止没必要的重复注释信息。

示例:如下注释意义不大。

/* if receive_flag is TRUE */if (receive_flag)

而如下的注释则给出了额外有用的信息。

/* if mtp receive a message from links */if (receive_flag)

2-14:在程序块的结束行右方加注释标记,以表明某程序块的结束。

说明:当代码段较长,特别是多重嵌套时,这样做可以使代码更清晰,更便于阅读。示例:参见如下例子。

if (…){// program codewhile (index < MAX_INDEX){// program code} /* end of while (index < MAX_INDEX) */ // 指明该条while 语句结束} /* end of if (…)*/ // 指明是哪条if 语句结束

2-15:注释格式尽量统一,建议使用“/*…… */”。

2-16:注释应考虑程序易读及外观排版的因素,使用的语言若是中、英兼有的,建议多使用中文,除非能用非常流利准确的英文表达。

说明:注释语言不统一,影响程序易读性和外观排版,出于对维护人员的考虑,建议使用中文。

更多编程相关知识,请访问:编程教学!!

以上就是在c程序中,注释语句只能位于一条语句的后面吗的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1434822.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月17日 10:09:08
下一篇 2025年12月8日 08:19:49

相关推荐

  • C语言中数组所占字节怎么算

    数组在内存中所占字节数可以使用sizeof操作符来计算,该操作符是专门用于检测类型或变量或数组在内存中所占有的空间(字节数);语法“sizeof(x)”,其中x是类型名、变量名或数组名等,可以返回x所占字节数。 本教程操作环境:windows7系统、c99版本、Dell G3电脑。 相关推荐:C语言…

    2025年12月17日
    000
  • c语言绝对值怎么打

    c语言绝对值的实现方法:1、如果是整形数字,则可以使用abs函数得到其绝对值;2、如果是浮点型数字,则可是用fabs函数得到其绝对值。 本文操作环境:Windows7系统,Dev-C++ 5.11版本,Dell G3电脑。 c语言绝对值的实现方法: 1、在C语言中,可以用abs或者fabs函数可以得…

    2025年12月17日 好文分享
    000
  • getch()的功能是什么

    getch()的功能是从控制台读取一个字符,但不显示在屏幕上;当用户按下某个字符时,函数自动读取,无需按回车。其语法格式为“int getch(void)”,在使用getch()时,需要引入头文件“conio.h”。 本文操作环境:宏基s40-51、dev-c++ 5.11版、windows10家庭…

    2025年12月17日
    000
  • c语言本身没有输入输出语句吗

    正确。C语言程序库内包含了printf和scanf这两个函数,当用户需要输入输出时,就要输入这两个函数,编译时C语言程序库则调用这两个函数,所以C语言本身是不能输入输出的。 本教程操作环境:windows7系统、c99版本、Dell G3电脑。 c语言本身是没有输入输出语句的。 与其他的计算机程序设…

    2025年12月17日
    000
  • c语言程序从哪里开始执行

    一个C语言的执行是从本程序的main函数开始,到main函数结束;但需要注意的是,也是有特殊情况的,若是代码中出现了exit函数,则直接结束程序。 本教程操作环境:windows7系统、c99版本、Dell G3电脑。 c语言程序的执行总是起始于main函数。在一个C语言源程序中,无论main函数书…

    2025年12月17日
    000
  • scanf在c语言中的作用是什么?

    scanf()是C语言中的一个输入函数,作用是:从键盘获得用户输入,可以按用户指定的格式从键盘上把数据输入到指定的变量之中;基本语法格式为“scanf(“格式符”,输入参数)”。 相关推荐:C语言视频教程 scanf()函数 scanf()是C语言中的一个输入函数。与prin…

    2025年12月17日
    000
  • c语言中continue语句的作用是什么

    c语言中continue语句的作用是结束本次循环,即跳过循环体中下面尚未执行的语句,然后进行下一次是否执行循环的判定。需要注意的是continue语句只结束本次循环,而不是终止整个循环。 continue 的作用是结束本次循环,即跳过循环体中下面尚未执行的语句,然后进行下一次是否执行循环的判定。 注…

    2025年12月17日
    000
  • eof在c语言中表示什么

    eof在c语言中表示文件结束符。在while循环中以EOF作为文件结束标志,这种以EOF作为文件结束标志的文件,必须是文本文件。在文本文件中,数据都是以字符的ASCII码值的形式存放的。 在C语言中,或更精确地说成C标准函数库中表示文件结束符(end of file)。 在while循环中以EOF作…

    2025年12月17日
    000
  • c源程序中main函数的位置是什么?

    C语言规定,在一个源程序中,main函数的位置:可以是任意的;在执行一个c语言编写的程序时,main函数就相当于是执行程序的入口;不论main函数在整个过程中的位置如何,一个C程序总是从mam函数开始执行的。 本教程操作环境:windows7系统、c99版本、Dell G3电脑。 C语言规定,在一个…

    2025年12月17日
    000
  • C语言中sizeof和strlen的区别是什么

    C语言中sizeof和strlen的区别是:strlen是一个函数,用来计算指定字符串str的长度,但不包括结束字符(即null字符);而sizeof是一个单目运算符,不是函数。 区别分析: strlen 是一个函数,它用来计算指定字符串 str 的长度,但不包括结束字符(即 null 字符)。其原…

    2025年12月17日
    000
  • c语言语句以什么结束

    c语言每条语句以都英文输入状态下的【;】结束一条语句,不同的版编权程语言有不同的结束标志,Java,C也是以【;】作为一行语句的结束的标志,也有不需要用【;】作为一行语句结束的编程语言。 【相关学习推荐:C语言教程视频】 c语言源程序的每一条语句都英文输入状态下的“;”结束一条语句。 不同的版编权程…

    2025年12月17日
    000
  • c语言中undeclared identifier是什么意思?

    “undeclared identifier”是指“未声明的标识符”,是C语言中一种报错提示;一般是使用的变量或者函数没有定义,或者是定义的时候和调用的时候不一致导致的。 本文操作环境:windows7系统、Dell G3电脑、C11。 “undeclared identifier”的意思为“未声明…

    2025年12月17日
    000
  • c语言volatile关键字的作用是什么?

    c语言volatile关键字的作用:提醒编译器它后面所定义的变量随时都有可能改变,因此编译后的程序每次需要存储或读取这个变量的时候,告诉编译器对该变量不做优化,都会直接从变量内存地址中读取数据,从而可以提供对特殊地址的稳定访问,以免出错。 教程推荐:《c语言教程视频》 一.前言 1.编译器优化介绍:…

    2025年12月17日
    000
  • c语言中,char型数据是以什么形式存储的?

    c语言中,char型数据是“ASCII码”形式存储的。在C语言中,将一个字符常量放到一个字符变量中,实际并不是把该字符本身放到内存单元中,而是将与该字符相对应的ASCII码放到存储单元中。 教程推荐:《c语言教程视频》 C语言 字符型(char)简介 字符型(char)用于储存字符(characte…

    2025年12月17日
    000
  • c语言指针用法有哪些

    c语言指针用法:1、指针变量与普通变量一样默认值不确定,一般初始化为NULL;2、指针变量的用法与普通变量不同,一般以p结尾加以区分;3、指针变量的类型决定了通过指针变量访问内存时访问几个字节。 c语言指针用法: 一,指针定义: 指针变量的取值范围取值0~4G,是一种数据类型(无符号整数,代表了内存…

    2025年12月17日
    000
  • c语言源文件经过编译后生成文件的后缀是什么?

    c语言源文件经过编译后生成文件的后缀是“.obj”。C语言源程序经过编译程序编译之后,生成一个后缀为“.obj”的文件,最后由称为“连接程序”的软件,把此“.obj”文件与各种库函数连接在一起,生成一个后缀“.exe”的可执行文件。 本教程操作环境:windows7系统、c99版本、Dell G3电…

    2025年12月17日
    000
  • c语言程序中的基本功能模块为什么?

    c语言程序中的基本功能模块为“函数”。一个C语言程序可以由一个主函数和若干个函数构成;一个大的应用程序一般应该分为多个程序模块,每一个模块用来实现一个功能,而模块的功能是由函数完成的。 教程推荐:《c语言教程视频》 c语言程序中的基本功能模块为“函数”。 一个 C语言程序可以由一个主函数和若干个函数…

    2025年12月17日
    000
  • c语言中字符常量是什么?

    c语言中字符常量是指由一对单引号括起来的单个字符,如“ ‘a’”、“’D’”、“’?’”、“’$’”;它代表ASCII字符集中的一个字符,在内存中占4个字节,存放的是字符的ASCII码(整型数据)。C语言…

    2025年12月17日
    000
  • c语言的输入输出语句有哪些?

    c语言的输入输出语句有:“getchar(void);”和“putchar(int c);”、“scanf(“格式控制字符串”,地址列表);”和“printf(“格式控制字符串”,输出列表);”、“gets()”和“puts()”等等。 教程推荐:《c…

    2025年12月17日
    000
  • c语言中数据结构是什么?常见数据结构有哪些?

    c语言中,数据结构是指相互之间存在一种或多种特定关系的数据元素的集合,它是计算机存储、组织数据的方式;常见数据结构有:线性数据结构(数组、链表、栈、队列和线性表)、树形结构(二叉树、完全二叉树、二叉查找树、堆)、图形结构(有向图和无向图)。 本教程操作环境:windows7系统、c99版本、Dell…

    2025年12月17日 好文分享
    000

发表回复

登录后才能评论
关注微信