当前位置:首页 > 黑客业务 > 正文内容

c语言一键注释(c语言自动注释)

hacker2年前 (2022-05-31)黑客业务91
本文导读目录:

C语言里有哪些注释方法

答:在用C语言编程时,常用的注释方式有如下几种:

(1)单行注释 //…

(2)多行注释 /*…*/

(3)条件编译注释 #if 0…#endif

拓展资料:

对于(1),注释只能显示在一行内,通常出现在一条语句的右边或者上方,对于注释符”//”,一个注释里只要有多余2个’/’都可以。

对于(2),”/*…*/”不能嵌套使用,正如”if…else”中的”else”总是和隔它最近的”if”配对一样,”/*”总是和离它最近的”*/”相配对。

针对(1)和(2)各自的缺陷,资深的程序员提出如(3)所示的注释,该注释的好处是能注释大块的程序,并且没有嵌套的限制,也就是说在”#if 0…#endif”的”…”处可以有”//”或”/*…*/”这样的注释。

C语言中如何注释?

一般来讲有两来种:

一是单行注释:直接在该行需要注释的地方加上"//"就行了。例如:

"int

a,b;//这是一个注释自行"。那么,"//"后面百的部分"这是一个注释行"就被注度释掉了,不起作用,但是"//"前面的“int

a,b;"不受影响。

另外还有一种是多行问同时注答释:

/*

int

a,b;

int

c,d;

*/

其中"/*"和"*/"起限定范围的作用,该范围内的语句都会被注释掉,将不再起作用。当然,多行注释也是可以用来单行注释的

c语言注释怎么写

C语言有两种注释格式,分别是:

单行注释

int x; // 这是一条行注释信息

多行注释

int x;

/* 这是一个

多行

注释

 */

C语言里有哪些注释方法?

两种,单行注释和成对注释。

单行注释以双斜线(//)开头。同一行中斜线右侧的所有内容都是注释,会被编译器略过。

另一个分隔符是注释符号对(/* */)。

C语言编程有哪些快捷键?

不知道您使用的是什么开发工具,如果是Visual Stdio的话

CTRL + SHIFT + B

生成解决方案

CTRL + F7

生成编译

CTRL + O

打开文件

CTRL + SHIFT + O

打开项目

CTRL + SHIFT + C

显示类视图窗口

F4

显示属性窗口

SHIFT + F4

显示项目属性窗口

CTRL + SHIFT + E

显示资源视图

F12

转到定义

CTRL + F12

转到声明

CTRL + ALT + J

对象浏览

CTRL + ALT + F1

帮助目录

CTRL + F1

动态帮助

F1

帮助

SHIFT + F1

当前窗口帮助

CTRL + ALT + F3

帮助-搜索

SHIFT + ALT + ENTER

全屏显示

CTRL + -

向后定位

CTRL + SHIFT + -

向前定位

CTRL + F4

关闭文档窗口

CTRL + PAGE DOWN

光标定位到窗口上方

CTRL + PAGE UP

光标定位到窗口下方

CTRL + F6

CTRL + TAB

下一个文档窗口

CTRL + SHIFT + F6

CTRL + SHIFT + TAB

上一个文档窗口

ALT + F6

下一个面板窗口

CTRL + K, CTRL + L

取消remark

CTRL + K, CTRL + C

注释选择的代码

CTRL + K, CTRL + U

取消对选择代码的注释

CTRL + M, CTRL + O

折叠代码定义

CTRL + M, CTRL + L

展开代码定义

CTRL + DELETE

删除至词尾

CTRL + BACKSPACE

删除至词头

SHIFT + TAB

取消制表符

CTRL + U

转小写

CTRL + SHIFT + U

转大写

CTRL + SHIFT + END

选择至文档末尾

CTRL + SHIFT + HOME

选择至文档末尾开始

SHIFT + END

选择至行尾

SHIFT + HOME

选择至行开始处

SHIFT + ALT + END

垂直选择到最后尾

SHIFT + ALT + HOME

垂直选择到最前面

CTRL + A

全选

CTRL + W

选择当前单词

CTRL + SHIFT + PAGE UP

选择至本页前面

CTRL + SHIFT + PAGE DOWN

选择至本页后面

CTRL + END

文档定位到最后

CTRL + HOME

文档定位到最前

CTRL + G

转到…

CTRL + K, CTRL + P

上一个标签

CTRL + K, CTRL + N

下一个标签

ALT + F10

调试-ApplyCodeChanges

CTRL + ALT+ Break

停止调试

CTRL + SHIFT + F9

取消所有断点

CTRL + F9

允许中断

CTRL + SHIFT + F5

调试-重新开始

F5

运行调试

CTRL + F5

运行不调试

F10

跨过程序执行

F11

单步逐句执行

CTRL + J

列出成员

CTRL + PAGE DOWN

下一个视图

CTRL + B

格式-粗体

CTRL + SHIFT + T

格式-文字缩进

C语言程序注释

C语言编程规范-注释

规则:

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

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

2:说明性文件(如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg等)头部应进行注释,注释必须列出:版权说明、版本号、生成日期、作者、内容、功能、与其它文件的关系、修改日志等,头文件的注释中还应有函数功能简要说明。

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

/*************************************************

Copyright (C), 1988-1999, Tech. Co., Ltd.

File name: // 文件名

Author:

Version:

Date: // 作者、版本及完成日期

Description: // 用于详细说明此程序文件完成的主要功能,与其他模块

// 或函数的接口,输出值、取值范围、含义及参数间的控

// 制、顺序、独立或依赖等关系

Others: // 其它内容的说明

Function List: // 主要函数列表,每条记录应包括函数名及功能简要说明

1. ....

History: // 修改历史记录列表,每条修改记录应包括修改日期、修改

// 者及修改内容简述

1. Date:

Author:

Modification:

2. ...

*************************************************/

3:源文件头部应进行注释,列出:版权说明、版本号、生成日期、作者、模块目的/功能、主要函数及其功能、修改日志等。

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

/************************************************************

Copyright (C), 1988-1999, Tech. Co., Ltd.

FileName: test.cpp

Author:

Version :

Date:

Description: // 模块描述

Version: // 版本信息

Function List: // 主要函数及其功能

1. -------

History: // 历史修改记录

author time version desc

David 96/10/12 1.0 build this moudle

***********************************************************/

说明:Description一项描述本文件的内容、功能、内部各部分之间的关系及本文件与其它文件关系等。History是修改历史记录列表,每条修改记录应包括修改日期、修改者及修改内容简述。

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

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

/*************************************************

Function: // 函数名称

Description: // 函数功能、性能等的描述

Calls: // 被本函数调用的函数清单

Called By: // 调用本函数的函数清单

Table Accessed: // 被访问的表(此项仅对于牵扯到数据库操作的程序)

Table Updated: // 被修改的表(此项仅对于牵扯到数据库操作的程序)

Input: // 输入参数说明,包括每个参数的作

// 用、取值说明及参数间关系。

Output: // 对输出参数的说明。

Return: // 函数返回值的说明

Others: // 其它说明

*************************************************/

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

6:注释的内容要清楚、明了,含义准确,防止注释二义性。

说明:错误的注释不但无益反而有害。

7:避免在注释中使用缩写,特别是非常用缩写。

说明:在使用缩写时或之前,应对缩写进行必要的说明。

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

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

例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;

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

示例:

/* active statistic task number */

#define MAX_ACT_TASK_NUMBER 1000

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

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

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

/* 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*/

};

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

示例:

/* 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;

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

说明:可使程序排版整齐,并方便注释的阅读与理解。

示例:如下例子,排版不整齐,阅读稍感不方便。

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

}

13:将注释与其上面的代码用空行隔开。

示例:如下例子,显得代码过于紧凑。

/* code one comments */

program code one

/* code two comments */

program code two

应如下书写

/* code one comments */

program code one

/* code two comments */

program code two

14:对变量的定义和分支语句(条件分支、循环语句等)必须编写注释。

说明:这些语句往往是程序实现某一特定功能的关键,对于维护人员来说,良好的注释帮助更好的理解程序,有时甚至优于看设计文档。

15:对于switch语句下的case语句,如果因为特殊情况需要处理完一个case后进入下一个case处理,必须在该case语句处理完、下一个case语句前加上明确的注释。

说明:这样比较清楚程序编写者的意图,有效防止无故遗漏break语句。

示例(注意斜体加粗部分):

case CMD_UP:

ProcessUp();

break;

case CMD_DOWN:

ProcessDown();

break;

case CMD_FWD:

ProcessFwd();

if (...)

{

...

break;

}

else

{

ProcessCFW_B(); // now jump into case CMD_A

}

case CMD_A:

ProcessA();

break;

case CMD_B:

ProcessB();

break;

case CMD_C:

ProcessC();

break;

case CMD_D:

ProcessD();

break;

...

建议:

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

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

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

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

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

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

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

/* if receive_flag is TRUE */

if (receive_flag)

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

/* if mtp receive a message from links */

if (receive_flag)

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

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

示例:参见如下例子。

if (...)

{

// program code

while (index MAX_INDEX)

{

// program code

} /* end of while (index MAX_INDEX) */ // 指明该条while语句结束

} /* end of if (...)*/ // 指明是哪条if语句结束

5:注释格式尽量统一,建议使用"/* …… */"。

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

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

给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。

在引号中,如果采用/*或//分隔一个字符常量或字符串字面量(string literal),它们都不会被视为注释的开始。例如,下面语句就没有注释:

printf("Comments in C begin with /* or //.\n" );

预处理器仅通过检查注释的结束符来检测注释中的字符,因此,不能嵌套块注释。然而,可以使用/*和*/注释包含单行注释的源代码:

/* 暂时注释掉这两行:

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

area = pi * r * r; // 计算面积

暂时注释到此 */

如果想要注释掉包含块注释的部分程序,可以使用条件预处理命令:

#if 0

const double pi = 3.1415926536; /* pi是一个常量 */

area = pi * r * r ; /* 计算面积 */

#endif

预处理器会把每个注释都替换成一个空格。因此,min/*max*/Value变成两个标记min Value。

所有教程

扫描二维码推送至手机访问。

版权声明:本文由黑客平台在线接单_免费黑客平台的网站发布,如需转载请注明出处。

本文链接:http://heikexuexi.com/24219.html

分享给朋友:

“c语言一键注释(c语言自动注释)” 的相关文章

家庭教育对孩子的影响

家庭教育对孩子的影响

儿童的性情 战风俗 取野庭学育互相关注 ,野庭学育的利害 以至否能影响儿童的平生 。是以 ,愈来愈多的怙恃 异常 看重 儿童的学育。现在 ,年夜 多半 怙恃 正在儿童正在母亲肚子面的时刻 便曾经开端 接管 学育,怙恃 盼望 儿童变患上良好 。野庭学育 对于儿童的影响有多年夜 ?野庭学育 对于儿童的影...

卫生院健康教育工作计划

卫生院健康教育工作计划

                                                                                               卫生院健康 学术事务 计划 是国家 肯定 私人卫生事务 名称之一,健康 学术正在提升住民 健康 培养,倡导 健...

销售助理工作总结

销售助理工作总结

                                                                                               无论你在哪里停止工作, 仍然是一个普通的 学习生涯 真的需要 继续 总结,只要通过 总结,能力 更糟糕的天空找...

西部志愿者工作总结

西部志愿者工作总结

                                                                                               许多 人应该有自愿 的经验 ,更紧的应该是作为一个图书馆 自愿 。自愿 运动 是一种通知 爱和传播 文化的风格...

求职简历自我评价

求职简历自我评价

                                                                                               在我的简历之外,自我评估的内容长度通常是 。对于 ,让我们来谈谈如何让我们在简历之外做一个自我评估部门 ?昨天...

 个人简历自我介绍

个人简历自我介绍

                                                                                               一个孬的毛遂自荐 每每 可以或许 给供职者的小我 简历添分,也是小我 简历外异常 主要 的构成 部门 。昨天正...

评论列表

澄萌末屿
2年前 (2022-06-01)

this message */ N_UNITDATA_REQ, /* sccp user's unit data transmission request*/};11:全局变量要有较

掩吻酒事
2年前 (2022-05-31)

N 选择至本页后面 CTRL + END 文档定位到最后 CTRL + HOME 文档定位到最前 CTRL + G 转到… CTRL + K, CTRL + P 上一个标签 CTRL + K, CT

笙沉路弥
2年前 (2022-06-01)

一种是多行问同时注答释:/*inta,b;intc,d;*/其中"/*"和"*/"起限定范围的作用,该范围内的语句都会被注释掉,将不再起作用。当然,多行注释也是可以用来单行注释的c语言注释怎么写C语言有两种注释格式,分别是:单行注释int x; // 这是一条行注释信息多行

怎忘午言
2年前 (2022-06-01)

重新开始 F5 运行调试 CTRL + F5 运行不调试 F10 跨过程序执行 F11 单步逐句执行 CTRL + J 列出成员 CTRL + PAGE DOWN 下一个视图 CTRL + B 格式-粗

笙沉氿雾
2年前 (2022-06-01)

应考虑程序易读及外观排版的因素,使用的语言若是中、英兼有的,建议多使用中文,除非能用非常流利准确的英文表达。说明:注释语言不统一,影响程序易读性和外观排版,出于对维护人员的考虑,建议使用中文。给c语

发表评论

访客

◎欢迎参与讨论,请在这里发表您的看法和观点。