【数据库编程标准规范系列】之第八章:代码的注释

WBOY
풀어 주다: 2016-06-07 15:24:03
원래의
1094명이 탐색했습니다.

不编写注释的理由: 费时间 很难写注释(客户更难读懂=烂代码) 8.1 编程原则 8.1.1 出色的注释,给代码增加信息量 8.1.3注释,捕获代码中的错误,为什么要捕获?什么错误?错误分类的阐述? 8.1.4 在编写代码前,进行注释 编写完整句子的注释或伪代码,注释

不编写注释的理由:

费时间

很难写注释(客户更难读懂=烂代码)

 

8.1 编程原则

8.1.1 出色的注释,给代码增加信息量

8.1.3注释,捕获代码中的错误,为什么要捕获?什么错误?错误分类的阐述?

8.1.4 在编写代码前,进行注释

编写完整句子的注释或伪代码,注释之间编写代码

8.1.5 纯色字符注释行

8.1.8注释可读性,供人阅读(难以理解的注释=根本没有注释)

注释属于文字信息

 

实际应用举例

使用完整的语句(最好不要分成段落)

避免使用缩写

将整个单词大写,突出重要性

 

8.1.9 注释缩进,与代码语句对齐

8.1.10每过程都应该有一个注释标头,格式化

8. 1.11 内部注释,说明代码进程

(1)每个If语句前加注释

(2)每个Select Case语句前加注释

(3)每个循环(For. . . Next和Do循环)前加注释

(4)在修改了全局变量的每个语句前面加上注释,便于调试

8.1.12行尾注释,较短描述;内部注释,较长描述

원천:php.cn
본 웹사이트의 성명
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.
인기 튜토리얼
더>
최신 다운로드
더>
웹 효과
웹사이트 소스 코드
웹사이트 자료
프론트엔드 템플릿