文章标题:PHP编码规范
作者: 时间:2008-01-20 翻译网站: 点击:146608 本文共10篇文章
发表评论 | 查看评论 | 加入收藏 | Email给朋友 | 打印本文 | 字体:[大 中 小]
发表评论 | 查看评论 | 加入收藏 | Email给朋友 | 打印本文 | 字体:[大 中 小]
- 第二章 : 2 文件名
- 第三章 : 3 源文件的编码规范
- 第四章 : 4 注释 <<==您当前正在阅读的章节
- 第五章 : 5 声明
- 第六章 : 6 语句
4 注释
4 注释 1
块注释通常用于提供对文件,方法,数据结构和算法的描述。块注释被置于每个文件的开始处以及每个方法之前。它们也可以被用于其他地方,比如方法内部。在功能和方法内部的块注释应该和它们所描述的代码具有一样的缩进格式。 本文来自 www.444p.com
块注释之首应该有一个空行,用于把块注释和代码分割开来,比如:
php学习之家
/*
* 这里是块注释
*/
www.444p.com版权所有
块注释可以以/*-开头,这样indent(1)就可以将之识别为一个代码块的开始,而不会重排它。
www.444p.com版权所有
/*-
* 如果想被忽略,可是使用特别格式的块注释
*
* one
* two
* three
*/
www.444p.com版权所有
注意:如果你不使用indent(1),就不必在代码中使用/*-,或为他人可能对你的代码运行indent(1)作让步。
责任编辑:semirock