`

关于程序注释的基础知识

阅读更多

关于程序注释的基础知识

作者:陈跃峰

出自:http://blog.csdn.net/mailbomb

程序注释是书写规范程序时很重要的一个内容,下面是关于注释的一些说明:

l 注释的作用:方便代码的阅读和维护(修改)。

l 注释在编译代码时会被忽略,不编译到最后的可执行文件中,所以注释不会增加可执行文件的大小。

l 注释可以书写在代码中的任意位置,但是一般写在代码的开发或者结束位置。

l 修改程序代码时,一定要同时修改相关的注释,保持代码和注释的同步。

l 在实际的代码规范中,要求注释占程序代码的比例达到20%左右,即100行程序中包含20行左右的注释。

分享到:
评论

相关推荐

    C8051程序注释

    C8051单片机编程例程注释 从给定的文件信息中,我们可以提炼出以下知识点: 1. C8051单片机编程:C8051是一个单片机平台,提供了丰富的编程接口和开发工具。该平台常用于工业控制、消费电子、医疗设备等领域。 2....

    VC++程序设计基础知识

    【VC++程序设计基础知识】是计算机编程领域的一个重要主题,主要涵盖了编码基础、数据类型、变量、表达式、控制结构、数组、函数和指针等内容。C++是基于C语言并扩展了面向对象编程功能的语言,而Visual C++ 6.0是...

    带注释的Java聊天程序 课程设计

    总的来说,这个“带注释的Java聊天程序”课程设计涵盖了Java编程基础、网络通信、多线程、IO流和可能的GUI设计等多个重要知识点。通过实践这个项目,学习者不仅可以提升编程技能,还能对Java应用程序的开发有一个...

    c语言程序实例大全(有目录,有注释)

    首先,让我们探讨C语言的基础知识。C语言的基本结构包括变量、数据类型、运算符、控制结构等。变量是存储数据的容器,它们可以是整型(如int)、浮点型(如float)、字符型(如char)等。数据类型的正确选择对于效率...

    汇编数制转换程序原创有注释

    本项目名为“汇编数制转换程序原创有注释”,它是一个使用轻松汇编(可能是某种特定的汇编器或模拟器)编写的交互式程序,专门用于进行数制转换。下面将详细探讨这个项目中的关键知识点。 首先,我们来看“汇编语言...

    vc++多人聊天程序(带有详细注释)

    1. **网络编程基础**:在VC++中实现聊天程序,需要用到网络编程技术,如套接字(Sockets)编程,它是TCP/IP协议族的一部分,用于在不同计算机之间建立连接并交换数据。 2. **客户端-服务器架构**:客户端是用户交互...

    C# 计算器(加了注释)

    【C# 计算器(加了注释)】是一个基于C#编程语言实现的简易...通过深入学习和实践这个C#计算器项目,开发者不仅可以巩固C#编程基础知识,还能进一步理解面向对象编程的思想,为将来开发更复杂的项目奠定坚实的基础。

    三菱PLC程序源码-三万多步马扎克系统三菱梯形图程序英文注释(日本人写).zip

    4. **程序注释**:程序中包含英文注释,这是理解代码逻辑的关键。这些注释由日本人编写,可能涉及到日本工业标准和编程习惯,对于提升跨文化交流和理解也有帮助。 5. **程序结构分析**:一个三万多步的程序,通常会...

    物联网通信_ZigBee的程序注释

    在程序注释中,你将看到以下几个关键知识点: 1. **初始化过程**:ZigBee设备启动时,需要进行网络初始化,包括设置网络ID(Network ID)、设备地址(Device Address)等参数。这是通过调用特定的初始化函数来完成...

    F28335学习程序,带详细中文注释

    【标题】"F28335学习程序,带详细中文注释"指的是一个针对Texas Instruments(TI)的TMS320F28335微控制器的学习资源。这个程序集包含了源代码和丰富的中文注释,旨在帮助初学者理解和掌握这款高性能的C28x浮点微...

    c++完美演泽程序注释版

    在"完美演泽程序注释版"中,你将找到这些知识点的实际应用实例,每个例子都配有详细的注释,帮助你理解和消化每一个概念。通过这些源码的学习,你可以逐步提升自己的C++编程技能,从基本语法到高级特性,都能得到...

    C语言程序的设计基础.pdf

    本资料主要涵盖了C语言程序设计的基础知识,包括程序设计语言的基本概念、C语言程序的基本结构、基本数据类型、运算符与表达式等方面。 1. 程序设计语言的基本概念: - 程序:一组按照特定规则组织的指令集合,...

    Java程序设计案例包含注释

    本压缩包中的"Java程序设计案例包含注释"是学习Java编程的重要资源,它涵盖了Java的基础知识,包括基本语法、面向对象概念、字符串处理以及异常处理等方面。下面将对这些知识点进行详细的阐述。 1. **Java基本语法*...

    超详细的有注释的pl0程序

    学习这样的程序不仅可以帮助你掌握PL/0语言,还可以为你提供编译器设计的基础知识。当你阅读注释并分析程序时,你可能会遇到词法分析(lexical analysis)、语法分析(parsing)、中间代码生成(intermediate code ...

    去除源代码注释

    在编程世界中,源代码注释是极其重要的,它们提供了对程序逻辑的解释,帮助开发者理解和维护代码。然而,在某些特定情况下,如编译优化、代码混淆或仅需执行无注释版本时,可能需要去除源代码中的注释。本文将深入...

    全国计算机等级考试二级公共基础知识总结

    全国计算机等级考试二级公共基础知识总结 1 程序设计设计方法和风格 如何形成良好的程序设计风格 1、源程序文档化; 2、数据说明的方法; 3、语句的结构; 4、输入和输出。 注释分序言性注释和功能性注释,语句结构...

    第2章 C语言程序基础知识.ppt

    在C语言程序设计中,掌握基础知识是至关重要的。本章主要涵盖了C语言的字符集、标识符、程序的基本结构和书写规则。以下是这些知识点的详细解释: 2.1 C语言的字符集和标识符: C语言的字符集包括字母、数字、空格...

    Java基础知识梳理

    "Java基础知识梳理" Java 是一种广泛使用的编程语言,适合初学者对 Java 相关知识的总结。下面是 Java 基础知识的梳理: 一、Java 开发环境 * JDK(Java Development Kit):可以开发编译与运行 JAVA 程序的工具...

    51组合机程序有注释.zip

    在51单片机程序中,注释可能涵盖了以下几个方面的知识点: 1. **汇编语言基础**:51单片机的程序通常使用汇编语言编写,这是一种低级语言,直接对应于机器指令。通过注释,我们可以学习到如何使用汇编指令进行数据...

Global site tag (gtag.js) - Google Analytics