在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月17日 10:09:37

相关推荐

  • css样式表怎么添加注释

    在css样式表中,可以使用“/* */”符号来添加注释,只需要使用“/*”和“*/”将需要注释的内容包裹即可,语法“/* 注释内容 */”;style标签中css代码,在某些旧版浏览器中还可以使用“”来添加注释。 本教程操作环境:windows7系统、CSS3&&HTML5版、Del…

    2025年12月24日
    000
  • css中怎么进行注释

    在css中注释的方法是使用符号【/**/】,例如【/*定义网页的头部样式*/】。在css中所有被放在【/*】和【*/】分隔符之间的文本信息都被称为注释。 本文操作环境:windows10系统、css 3、thinkpad t480电脑。 在 CSS 中增加注释很简单,所有被放在/*和*/分隔符之间的…

    2025年12月24日
    000
  • css样式的注释怎么写

    在css中,无论多行注释还是单行注释,都必须以“/*”开始、以“*/”结束,中间加入注释内容;语法格式为“/* 需要注释的内容 */”。“*”符号不要和注释内容紧挨在一起,至少需要一个空格位置空着。 本教程操作环境:windows7系统、CSS3&&HTML5版、Dell G3电脑。…

    2025年12月24日
    000
  • css注释的两种写法是什么

    css注释的两种写法是单行注释和多行注释,语法格式如【/* Comment */】。在外部独立的css文件中,没有其他声明注释的方法。【/*】之后的第一个【*/】记号就会结束注释。 本文操作环境:windows10系统、css 3、thinkpad t480电脑。 CSS 注释用于为代码添加额外的解…

    2025年12月24日
    000
  • html5如何改成flash_HTML5替代Flash方案与迁移技巧【方法】

    需用HTML5替代Flash:一、Canvas/SVG重写动画图形;二、Video/Audio元素+Web Audio API替代音视频;三、WebSocket/Fetch重构通信;四、Emscripten将AS3转WebAssembly;五、Ruffle模拟器运行遗留SWF。 如果您正在处理一个原…

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

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

    2025年12月23日
    000
  • 怎么在HTML上运行C语言_HTML上运行C语言方法【教程】

    使用Emscripten将C代码编译为WebAssembly,通过emcc生成HTML和wasm文件,在浏览器中运行;2. 借助JS-Interpreter类库在前端模拟执行简单C代码,适用于教学场景;3. 通过WebSocket连接远程Linux终端,利用xterm.js和后端服务实现C程序的编译…

    2025年12月23日
    000
  • 怎么用c 运行html_C运行html方法【教程】

    可通过system函数调用系统命令打开HTML文件,如Windows下使用start命令,Linux用xdg-open,macOS用open;也可生成HTML内容写入临时文件后调用命令打开;还可使用CreateProcess(Windows)或fork/exec(Linux/macOS)等API更安…

    2025年12月23日
    000
  • 怎么在html里运行c程序_html中运行c程序方法【教程】

    可通过Emscripten将C编译为WebAssembly、调用在线编译API或结合Node.js后端执行C程序。首先推荐使用Emscripten工具链,将C代码(如hello.c)通过emcc命令编译成.wasm文件,并生成配套的HTML和JavaScript文件,在本地服务器运行即可在浏览器中执…

    2025年12月23日
    000
  • 怎么样用c语言运行html_c语言运行html方法【教程】

    C语言可通过三种方式处理HTML:1. 用fopen、fprintf生成静态HTML文件并保存;2. 编写HTTP服务器,通过套接字监听请求并返回HTML响应;3. 生成文件后调用system执行系统命令打开HTML预览。 如果您希望在C语言程序中处理或生成HTML内容,通常是因为需要创建动态网页内…

    2025年12月23日
    000
  • c 怎么运行html文件路径_C运行html文件路径方法【教程】

    答案:通过system()函数调用系统命令可打开HTML文件。一、使用system(“start 文件路径”)在Windows打开,Linux用xdg-open;二、动态拼接路径提高可移植性;三、生成临时HTML文件后自动打开。 如果您尝试在C语言程序中打开或运行HTML文件…

    2025年12月23日
    000
  • html怎么运行c_html中调用运行C语言方法【教程】

    可在HTML中通过三种方式调用C语言代码:一、用Emscripten编译为WebAssembly并在JS中调用;二、通过Node.js后端执行C可执行文件并返回结果;三、配置CGI使Web服务器直接运行C程序。 如果您希望在HTML中实现与C语言的交互,以调用C语言编写的函数或程序,需要借助特定技术…

    2025年12月23日
    000
  • 文本文档c语言怎么在html运行_文本文档c语言嵌入html运行法【技巧】

    可通过Emscripten将C代码编译为WebAssembly在HTML中运行,或嵌入JDoodle等平台的交互式编辑器实现在线执行,也可用Prism.js高亮代码并结合JavaScript模拟输出效果。 如果您希望在网页中展示C语言代码的运行效果,由于HTML本身无法直接执行C语言程序,必须借助外…

    2025年12月23日
    000
  • 解决Haskell CGI中因文件读取编码导致HTML输出截断的问题

    本文旨在解决Haskell CGI应用程序在Apache环境下,从文件读取数据生成动态HTML时,可能出现HTML输出截断的问题。核心原因在于CGI运行环境的默认语言环境(LANG=C)与文件内容编码(通常为UTF-8)不匹配,导致Haskell在读取文件时抛出无效字节序列错误。解决方案是通过显式设…

    2025年12月23日
    000
  • 解决Haskell CGI应用中文件读取导致的HTML输出截断问题

    本文旨在解决Haskell CGI应用程序在读取包含Unicode字符的文件时,通过Apache等Web服务器运行时可能出现的HTML输出截断问题。核心原因在于CGI环境默认的`LANG=C`导致编码不匹配。解决方案是利用`GHC.IO.Encoding.setLocaleEncoding utf8…

    2025年12月23日
    000
  • HTML5WebGL怎么入门_HTML5WebGL3D图形编程的基础知识与实例

    先掌握WebGL渲染管线原理并实践绘制三角形,再通过Three.js等库实现3D场景。1. 理解WebGL基于着色器的渲染机制,使用GLSL编写顶点和片元着色器。2. 初始化WebGL环境,编译着色程序,传入顶点数据并调用drawArrays绘制彩色三角形。3. 引入模型、视图和投影矩阵实现3D空间…

    2025年12月23日
    000
  • html你如何注释_HTML代码注释()语法与规范写法

    HTML注释以结束,用于添加说明且不显示在页面中。正确使用可提升代码可读性与维护效率。应简洁标注复杂逻辑、代码段起止或临时禁用内容,如…;可标记页眉、导航等区域便于定位;调试时注释代码避免删除;兼容性处理可用条件注释,如,仅IE识别。避免过度注释显而易见的代码,如与搭配冗余。最佳实践包括…

    2025年12月23日 好文分享
    100
  • 将列表字典转换为扁平化值列表的Pythonic方法

    本文旨在介绍如何利用python的列表推导式,高效且简洁地将一个包含多个字典的列表,扁平化为一个只包含所有字典值的单一列表。通过详细的代码示例和解析,读者将掌握这一常用的数据处理技巧,提升代码的简洁性和执行效率。 在数据处理和分析的场景中,我们经常会遇到需要从复杂数据结构中提取特定信息的情况。其中一…

    2025年12月23日
    000
  • Python教程:将字典列表扁平化为值列表

    本教程将指导您如何高效地将一个包含多个字典的列表转换为一个单一的、扁平化的值列表。我们将探讨如何利用python的列表推导式,以简洁优雅的方式提取所有字典中的值,并将其整合到一个新的列表中,适用于处理结构化数据并进行进一步分析或展示的场景。 在数据处理和分析的场景中,我们经常会遇到需要将复杂的数据结…

    2025年12月23日
    000
  • Python教程:将字典列表中的所有值扁平化为单一列表

    本教程详细阐述了如何使用python高效地将一个包含多个字典的列表扁平化为一个单一的值列表。通过利用简洁而强大的嵌套列表推导式,我们可以快速遍历列表中的每个字典及其键值对,提取所有值并将其整合到一个新的列表中,从而实现复杂数据结构的扁平化,适用于数据预处理和信息提取等场景。 在数据处理和分析中,我们…

    2025年12月23日
    000

发表回复

登录后才能评论
关注微信