Deprecated: imwpcache\f884414bce24ee67f\f73723ec7b1919fa5::__construct(): Implicitly marking parameter $YECBGYFECGEAFWHA as nullable is deprecated, the explicit nullable type must be used instead in /www/wwwroot/www.chuangxiangniao.com/wp-content/plugins/imwpcache-dist/build/f884414bce24ee67ff73723ec7b1919fa5.php on line 2

Deprecated: imwpcache\f884414bce24ee67f\f73723ec7b1919fa5::__construct(): Implicitly marking parameter $BBWFDDBHHYHDXXAB as nullable is deprecated, the explicit nullable type must be used instead in /www/wwwroot/www.chuangxiangniao.com/wp-content/plugins/imwpcache-dist/build/f884414bce24ee67ff73723ec7b1919fa5.php on line 2
在c程序中,注释语句只能位于一条语句的后面吗_创想鸟

在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

相关推荐

  • rm -rf 误删文件?别急,或许有救!

    rm -rf 误删文件?别急,或许有救!rm -rf 误删文件?别急,或许有救!rm -rf 误删文件?别急,或许有救!rm -rf 误删文件?别急,或许有救!

    立即采取行动! 在生产环境中,我们应尽量避免进行风险操作。但如果不慎犯错,如何挽救呢?让我分享一个故事:上周我为了打包一个应用,需要整理Ubuntu 16.04上的线上数据,不小心删除了一个数据文件,幸而最终有惊无险,现记录如下。 extundelete 我的恢复计划主要依赖于一个工具——extun…

    2026年9月22日 用户投稿
    000
  • python 基准测试(cProfile kcachegrind line_profiler memory_profiler)

    learn from 《python高性能(第2版)》 类似工具:pycharm profile对函数调用效率进行测试 1. 例子 一个圆周运动的动画 代码语言:javascript代码运行次数:0运行复制 from matplotlib import pyplot as pltfrom matpl…

    2026年9月22日
    200
  • VSCode安装C/C++开发环境 最新VSCode配置C语言教程详解

    答案:搭建VSCode的C/C++环境需安装编译器、C/C++扩展并配置项目文件。首先安装MinGW(Windows)、Clang(macOS)或GCC(Linux),配置环境变量并验证;然后在VSCode中安装Microsoft的C/C++扩展;最后创建.c_cpp_properties.json…

    2026年9月22日
    300
  • VSCode配置GDB调试器 深入掌握VSCode调试C程序技巧

    配置vscode中gdb调试c程序的核心是正确设置tasks.json和launch.json;2. tasks.json负责使用gcc -g编译生成带调试信息的可执行文件,确保prelaunchtask与launch.json中的program路径一致;3. launch.json指定调试器gdb…

    2026年9月22日
    100
  • VSCode配置C语言调试环境 从零开始VSCode搭建C开发工具

    要从零开始在#%#$#%@%@%$#%$#%#%#$%@_e2fc++805085e25c9761616c00e065bfe8中搭建c语言开发和调试环境,首先需安装vscode本体、c/c++编译器(如mingw或gcc)并配置系统环境变量,接着安装vscode的c/c++扩展,然后创建项目并编写c…

    2026年9月22日
    100
  • Linux中如何安装Redis_Linux安装Redis服务的完整教程

    安装编译环境和依赖:Ubuntu/Debian用apt安装build-essential tcl wget,CentOS/RHEL用yum安装Development Tools和tcl wget。2. 下载Redis 7.2.4源码包并%ignore_a_1%,进入目录后执行make编译,可选mak…

    2026年9月21日
    000
  • 如何在Java中实现简单的输入输出

    使用Scanner类读取键盘输入,需导入java.util.Scanner并创建实例;2. 调用nextInt、nextLine等方法获取不同类型数据,注意nextInt不读取换行符可能导致nextLine读取空字符串;3. 推荐使用后关闭Scanner;4. 输出通过System.out.prin…

    2026年9月21日
    000
  • Swoole如何做性能分析?分析工具有哪些?

    Swoole性能分析需结合内置监控与外部工具,先通过SwooleServer::stats()和系统监控定位异常,再用perf、strace或Blackfire等工具深入分析CPU、内存、I/O瓶颈,尤其关注协程阻塞与隐性同步操作,最后通过火焰图可视化热点,迭代优化并验证效果。 Swoole的性能分…

    2026年9月11日
    200
  • Swoole如何处理大JSON数据?JSON解析如何优化?

    Swoole处理大JSON时,核心在于非阻塞I/O与异步解析结合。首先,json_decode是CPU密集型操作,会阻塞Worker进程,导致内存激增、响应延迟和并发下降。其次,推荐采用流式解析库(如json-machine)逐块处理数据,降低内存占用。最后,利用Swoole的Task Worker…

    2026年9月11日
    000
  • VSCode注释技巧:生成文档与注解

    掌握VSCode%ignore_a_1%技巧可提升代码可读性与开发效率。1. 使用JSDoc添加函数说明,支持智能提示;2. 快捷键Ctrl/Cmd+/快速切换行注释,输入/**自动生成块注释;3. 配合”Document This”插件一键生成JSDoc模板;4. 利用js…

    2026年9月10日
    300
  • Linux下关于C语言队列问题的详解

    最近写程序用到了linux系统下c语言的队列操作,于是有了下面一个问题 下面是队列的代码: 这个队列头文件  extern struct pqueue Que;/*构造一个空队列*/extern pQueue *InitQueue();/*销毁一个队列*/extern void DestroyQue…

    用户投稿 2026年9月7日
    800
  • 使用Cython加速你的Python代码

    前言 如果你曾经用python编写过代码,可能已经发现某些代码块的执行时间比预期的长。尽管有几种方法可以提高代码效率,但python通常比c语言慢。这是因为python是一种动态编程语言,将许多c语言在编译时处理的任务推迟到运行时。 然而,如果你喜欢用Python编码并希望加快代码执行速度,可以考虑…

    2026年9月7日
    100
  • Win10系统玩LOL游戏打不开提示句柄无效怎么办?

    win10系统玩lol游戏无法启动并显示句柄无效怎么办?不少玩家喜欢在电脑上玩lol(英雄联盟),但在尝试打开游戏时,却遇到了无法启动的情况,同时还收到句柄无效的提示。如果你也遇到了这样的问题,本文将为你提供解决方案。 具体步骤: 处理方法: 如果提示是因为安装了第三方软件导致的,请尝试卸载这些软件…

    2026年9月7日
    200
  • 最小化Java中的可变范围:安全有效代码的最佳实践

    本文探讨了缩小Java变量作用域以提升代码可读性、可维护性和安全性至关重要的问题。文章将Java的面向对象方法与C等语言进行了对比,并通过方法封装和受控访问等最佳实践示例,阐述了如何有效地限制变量的作用域。 在Java中,变量的作用域是指程序中可以访问该变量的区域(Mahrsee, 2024)。作用…

    2026年9月7日
    000
  • Linux下通过grep查找指定的进程是否存在

    一、功能概述 在Linux系统中,可以使用命令行工具来检查特定进程是否运行,并返回其PID。通过这种方式,可以在程序中监控指定程序的运行状态,并在程序异常退出时自动重启该程序或系统。 二、执行命令 2.1 shell脚本示例 以下是使用shell脚本查找指定进程PID的代码: # 查找指定进程的PI…

    2026年9月5日
    200
  • C语言头文件防卫式声明

    c语言一般提供三种预处理功能:宏处理、文件包含、条件编译。头文件防卫式申明中会用到条件编译中 #ifndef 、 #define 、 #endif 的用法。所以,首先价绍下条件编译。 1 条件编译 一般情况下,在生成可执行文件的过程中,源程序文件中的所有代码行都进行编译,但是在一些跨操作系统的情况下…

    2026年9月4日
    200
  • Linux实现开机启动程序或脚本的详解

    很多时候我们需要在linux上设定一些服务或者脚本开机自启动,这样可以避免机器重启带来的服务中断等问题。下面我们来看一下linux下如何设置开启自启动: cd /etc/init.d vi myscript.sh #将myscript.sh修改为你自己的脚本名 编写自己的脚本后保存退出。 在编写脚本…

    用户投稿 2026年9月4日
    000
  • mysql中的注释有哪些

    mysql中的注释有哪些mysql中的注释有哪些mysql中的注释有哪些mysql中的注释有哪些

    mysql中有四种注释:1、单行注释“–”,语法“– 注释内容”;2、单行注释“#”,语法“#注释内容”;3、多行注释“/**/”,语法“/*注释内容 */”;4、内联注释“/*! */”,语法“/*!注释内容 */”。 本教程操作环境:windows7系统、mysql8版本…

    2026年9月3日 用户投稿
    100
  • mysql建表怎么添加注释

    在mysql中,可以使用“create table”语句和comment关键字来在建表时添加注释,语法“create table 表名 (字段名 字段类型 comment ‘字段的注释’)comment=’表注释’;”。 本教程操作环境:windows…

    2026年9月2日
    200
  • Java数组索引为什么从0开始而不是从1开始?

    Java数组索引为何从0而非1开始? 初学Java,你可能会疑惑:Java数组索引为何从0开始,而不是更常见的1?这与其他编程语言有所不同,但其原因源远流长。 Java沿用了C语言的数组索引方法。在C语言中,数组索引实质上是内存偏移量,首个元素位于当前内存指针位置(*(array 0))。这一约定可…

    2026年9月1日
    200

发表回复

登录后才能评论
关注微信