在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)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
C++如何给二维数组初始化
上一篇 2025年12月17日 10:09:08
textbox控件属性有哪些
下一篇 2025年12月17日 10:09:37

相关推荐

  • Python命令怎样使用profile分析脚本性能 Python命令性能分析的基础教程

    使用Python的cProfile模块分析脚本性能最直接的方式是通过命令行执行python -m cProfile your_script.py,它会输出每个函数的调用次数、总耗时、累积耗时等关键指标,帮助定位性能瓶颈;为进一步分析,可将结果保存为文件python -m cProfile -o ou…

    2026年5月10日
    000
  • python中numpy的用法

    NumPy是Python中用于科学计算的强大库,它提供了以下功能:多维数组处理矩阵运算快速傅里叶变换(FFT)线性代数随机数生成 NumPy在Python中的强大功能 NumPy是Python中用于科学计算的一个强大且灵活的库。它提供了用于处理多维数组和矩阵的一组高效工具,是数据分析和机器学习项目的…

    2026年5月10日
    100
  • c语言short怎么设置

    C语言中short类型数据为16位有符号整数,范围[-32768, 32767]。设置方法:1. 声明short变量(如:short myShort = 123;);2. 使用短整型字面量(如:myShort = 123S;);3. 使用类型转换(如:short myShort = (short) …

    2026年5月10日
    000
  • WebAssembly中导入JavaScript函数:无胶水代码集成指南

    本文深入探讨了在WebAssembly模块中直接导入和使用JavaScript函数的机制,特别是当使用Emscripten的STANDALONE_WASM和SIDE_MODULE编译模式时。文章详细分析了TypeError: import object field ‘GOT.mem&#8…

    2026年5月10日
    000
  • c语言整除函数怎么表示

    C语言中进行整数除法的函数是 /,其语法为 result = dividend / divisor,结果取整且不会有小数部分。 C 语言整除函数表示方法 C 语言中,用于进行整数除法的函数是 /。 语法: result = dividend / divisor; 其中: 立即学习“C语言免费学习笔记…

    2026年5月10日
    000
  • 人工智能如何为 C 语言代码提供安全增强功能?

    人工智能通过提供以下功能来提升 c 代码安全性:静态分析:识别潜在安全漏洞(例如缓冲区溢出);动态分析:监控代码执行并检测异常行为;模糊测试:生成随机输入以测试代码的异常行为;自动化修复:建议修复措施或自动生成补丁程序。 人工智能赋能 C 代码:提升安全性 人工智能 (AI) 在 C 代码安全方面发…

    2026年5月10日
    100
  • Go语言Cgo代码GDB调试失效:Go 1.1版本下的挑战与官方进展

    本文探讨了go语言程序中cgo代码在使用gdb进行调试时遇到的挑战,特别指出go 1.1版本中存在的变量值显示异常问题。该问题是一个已知的官方缺陷(go issue 5221),导致在cgo交互部分gdb调试功能失效,而go 1.0版本则无此问题。文章将通过示例代码重现该现象,并阐述其根源及官方的解…

    2026年5月10日
    000
  • c语言中free(f)的意思

    c语言中free(f)的含义 free(f) 函数在 C 语言中释放由 malloc()、calloc() 或 realloc() 等函数动态分配的内存块。 作用: 释放动态分配的内存块。将指针 f 设置为 NULL。 语法: void free(void *f); 参数: 立即学习“C语言免费学习…

    用户投稿 2026年5月10日
    000
  • c语言中x*x是什么意思

    在 C 语言中,x*x 表示 x 与自身相乘的结果,即 x 的平方。它对应于数学中的 x²,优先级高于加减运算。用于计算面积、体积和求解二次方程,但需要注意浮点数精度可能导致轻微偏差。 x*x 在 C 语言中的含义 在 C 语言中,x*x 表示 x 与自身相乘的结果,即 x 的平方。它对应于数学中的…

    2026年5月10日
    000
  • c语言里面字符是什么意思

    字符在 C 语言中以单个字节存储于 char 变量中,用单引号括起表示常量,例如 ‘A’。字符变量用于存储字符值,可使用函数如 putchar() 输出、getchar() 输入、toupper() 转换大小写。字符数组存储多个字符,如 char name[10]。字符串是带…

    2026年5月10日
    000
  • Go语言在Linux上管理回环设备:os/exec与cgo的实现策略

    本文探讨了在Go语言中管理Linux回环设备(loopback devices)的两种主要策略。首先介绍通过os/exec包调用外部losetup命令的简洁高效方法,并提供示例代码。接着,深入分析了在不依赖外部命令时,利用cgo集成losetup.c底层C代码的复杂但直接的方案,并讨论了两种方法的优…

    2026年5月10日
    100
  • c语言函数声明的格式

    C语言函数声明以”返回值类型 函数名(参数列表)”组成,但细节丰富。参数修饰符const可防止参数修改,返回类型可为结构体、指针等。函数指针用于实现回调函数等。函数声明不仅说明函数存在,也定义接口,以进行类型检查并防止错误。 C语言函数声明:那些你可能不知道的细节 很多初学者…

    2026年5月10日
    000
  • PHP多维数组中提取指定键值并生成新数组的教程

    本教程详细讲解如何在PHP中从多维数组提取特定键的值,并将其聚合到一个新的、扁平化的数组中。文章将介绍使用foreach循环的传统方法,并重点推荐PHP 5.5+版本中更高效、简洁的array_column函数,同时提供代码示例和注意事项,帮助开发者优化数组数据处理逻辑。 在PHP开发中,我们经常会…

    2026年5月10日
    000
  • eof在c语言中表示什么

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

    2026年5月10日
    000
  • c语言结构体数组怎么用

    结构体数组是一种连续存储相同类型结构体元素的内存区域。定义语法:struct structure_name array_name[array_size];访问元素:array_name[index].member_name。 C语言结构体数组的使用 定义和初始化: 在C语言中,结构体数组是一个连续的…

    2026年5月10日
    000
  • c语言中10的n次方怎么表示

    在 C 语言中,用两种方法表示 10 的 n 次方:使用 pow() 函数,接受底数和指数,返回底数的指数次方。使用位移运算符 ( 如何用 C 语言表示 10 的 n 次方? 在 C 语言中,表示 10 的 n 次方的方法有两种: 方法 1:使用 pow() 函数 #include int main…

    2026年5月10日
    000
  • c语言goto怎么用

    goto 语句是一种 C 语言跳转语句,允许程序直接从当前位置跳转到程序中另一个标记位置。由于其可能导致程序难以理解、维护和调试,因此不推荐使用,但可以在没有替代方案的情况下谨慎使用。 C 语言中的 goto 语句 goto 语句是一种跳转语句,它允许程序从当前位置直接跳转到程序中的另一个位置。语法…

    2026年5月10日
    000
  • c语言如何生成html_用C语言程序输出HTML格式文件【文件】

    C语言动态生成HTML文件有五种方法:一、用fprintf逐行写入;二、构建缓冲区后fwrite一次性写入;三、用宏简化标签输出;四、从模板文件加载并替换变量;五、用结构体组织元素并序列化。 如果您希望使用C语言程序动态生成HTML格式的文件,则需要通过标准文件I/O操作将符合HTML语法的文本内容…

    2026年5月10日
    300
  • 如何在Python中创建XML文档?

    使用xml.etree.ElementTree创建XML的核心步骤包括:导入模块、创建根元素、添加子元素与属性、设置文本内容、生成ElementTree对象并写入文件;注意事项有:使用ET.indent()提升可读性、指定encoding=&quot;utf-8&quot;和xml_…

    2026年5月10日
    000
  • Go与.NET互操作:在Go应用中调用.NET库的策略

    本文探讨了在go应用中集成.net库或ui的策略。核心方法是通过在go进程中宿主.net clr,利用c-callable dll作为桥梁。文章将介绍这种技术的可行性,并讨论实现过程中可能遇到的技术细节和注意事项,帮助开发者实现go与.net之间的互操作性。 引言 在现代软件开发中,跨语言互操作性是…

    2026年5月10日
    000

发表回复

登录后才能评论
关注微信