c程序的注释符号(c语言程序注释符号)
您好,今天小编胡舒来为大家解答以上的问题。c程序的注释符号,c语言程序注释符号相信很多小伙伴还不知道,现在让我们一起来看看吧!
1、以注释内容开始。
2、关于程序中注释书写格式1程序文件注释:放在程序名称空间引用(using ***.io;)的上面,主要写公司的版权、文件创建的时间、文件的主要内容、文件的名字、文件的创建标识(创建人姓名)、文件修改的时间、文件修改时的修改标识(修改人姓名)、文件修改的修改原因等(详情见文档后备注示例);2类的作用注释:放在类(类、接口、枚举、结构体)的声明上方,主要描述类的作用。
3、如果类的结构比较复杂,也应该添加类的使用示例和类的流程(其它特点)3、类的私有全局重要变量注释:放在类的全局变量声明上方,主要需要注释通过命名不能正确理解的全局私有或公有(包含受保护等)变量。
4、如果是object(特殊数组等)型变量,内部使用时结构比较复杂或有规定,需要简要的说明一下内部结构。
5、4、类的属性的注释:放在类的属性声明上方,简要说明属性的类型和主要作用。
6、5、类的公有方法的注释:主要说明方法的作用,方法各参数的意义和要求,方法的返回值及各种可能的返回值的特殊意义,方法可能会产生的异常,如果需要,则可以写出方法的使用示例;6、类的私有方法或重要算法的注释:除了需要说明公有方法所要求的之外,如果算法、数学运算比较复杂,需要写出算法或数学方法的理论过程或推导过程;如果算法比较长,要尽可能的细分成逻辑块,并填写适当的注释;对于方法中的重要变量也要添加适当的注释,特别是对方法的结果或方法某一段的结果的方法内部不易理解的变量要添加合适的注释;对于特别复杂(重要)的方法,要添加适当的流程图或文档,给以充分的文字、图解等说明;7、文件、类或类的方法修改后的注释的变更:对于对文件或类(包括接口、枚举、结构体)或类的方法修改后,要添加修改后的相注释,要写清修改的时间、修改标识(修改人姓名)、修改的原因等一切必要的信息和一切必要变更的信息(类、方法的流程);。
本文就为大家分享到这里,希望小伙伴们会喜欢。
免责声明:本文由用户上传,与本网站立场无关。财经信息仅供读者参考,并不构成投资建议。投资者据此操作,风险自担。 如有侵权请联系删除!
-
在服务行业中,服务员的礼貌礼仪直接影响到顾客的体验和企业的形象。因此,开展系统的礼貌礼仪培训显得尤为重...浏览全文>>
-
混凝土作为一种广泛应用于建筑行业的材料,其凝固过程是施工过程中非常重要的一环。然而,许多人对于混凝土究...浏览全文>>
-
在日常生活中,我们常常会遇到一些简单的英语词汇,它们虽然常见,但有时却容易被忽略或混淆。例如,“服务员...浏览全文>>
-
在建筑施工中,混凝土是不可或缺的建筑材料之一。然而,很多人对于混凝土从浇筑到具备实际使用强度所需的时间...浏览全文>>
-
在建筑领域,“砼”这个字并不陌生,它其实是“混凝土”的简称。但为什么混凝土会被称为“砼”呢?这个问题看...浏览全文>>
-
在当今快速发展的商业环境中,服务式办公室(Serviced Office)已经成为越来越多企业和创业者的选择。它以其...浏览全文>>
-
在美食的世界里,一句好的广告语不仅能让人垂涎欲滴,更能深入人心,成为品牌文化的象征。无论是街头小吃还是...浏览全文>>
-
在小学阶段,数学作为一门基础学科,其重要性不言而喻。它不仅是培养逻辑思维能力的重要工具,也是学生未来学...浏览全文>>
-
在快节奏的生活环境中,人们越来越关注身心健康的重要性。健康心理学作为一门新兴的交叉学科,正逐渐成为现代...浏览全文>>
-
在过去的2018年里,无数女性以她们的智慧、勇气和奉献精神,在各自的岗位上书写了不平凡的篇章。她们是新时代...浏览全文>>