您当前的位置: 首页 > 网站编程 > PHP教程 > 都应该看看php标准的注释方法

都应该看看php标准的注释方法

作者:不详 来源:网络 发布时间: 2011-12-21 13:47 点击:
PHP注释(Comments)有两种类型,一种是单行注释,一种是多行注释。 PHP单行注释语法 在一行中所有DE//DE符号右面的文本都被视为注释,因为PHP解析器忽略该行DE//DE右面的所有内容。示例如下,红色字体部分就是单行注释的内容。 ?phpechoBlabla.cn;//这是单行注释?你也这

都应该看看php标准的注释方法

  PHP注释(Comments)有两种类型,一种是单行注释,一种是多行注释。
  
  PHP单行注释语法
  
  在一行中所有DE>//DE>符号右面的文本都被视为注释,因为PHP解析器忽略该行DE>//DE>右面的所有内容。示例如下,红色字体部分就是单行注释的内容。
  
  <?phpecho"Blabla.cn";//这是单行注释?>你也这样这样写,一行只写注释,不写代码,如下:
  
  <?php//这是单行注释echo"Blabla.cn";//这是单行注释?>PHP多行注释语法
  
  PHP多行注释以DE>/*DE>开头,以DE>*/DE>结束。在DE>/*DE>和DE>*/DE>之间,可以写多行注释。
  
  示例如下,红色部分就是多行注释的内容。
  
  <?phpecho"Blabla.cn";/*这是多行注释这是多行注释*/?>4.1块注释
  
  块注释通常用于提供对文件,方法,数据结构和算法的描述。块注释被置于每个文件的开始处以及每个方法之前。它们也可以被用于其他地方,比如方法内部。在功能和方法内部的块注释应该和它们所描述的代码具有一样的缩进格式。
  
  块注释之首应该有一个空行,用于把块注释和代码分割开来,比如:
  
  /*
  
  *这里是块注释
  
  */
  
  块注释可以以/*-开头,这样indent(1)就可以将之识别为一个代码块的开始,而不会重排它。
  
  /*-
  
  *如果想被忽略,可是使用特别格式的块注释
  
  *
  
  *one
  
  *two
  
  *three
  
  */
  
  注意:如果你不使用indent(1),就不必在代码中使用/*-,或为他人可能对你的代码运行indent(1)作让步。
  
  4.2单行注释
  
  短注释可以显示在一行内,并与其后的代码具有一样的缩进层级。如果一个注释不能在一行内写完,就该采用块注释。单行注释之前应该有一个空行。以下是一个代码中单行注释的例子:
  
  if(condition){
  
  /*以下代码运行的条件*/
  
  ...
  
  }
  
  4.3尾端注释
  
  极短的注释可以与它们所要描述的代码位于同一行,但是应该有足够的空白来分开代码和注释。若有多个短注释出现于大段代码中,它们应该具有相同的缩进。
  
  以下是一个代码中尾端注释的例子:
  
  if($a==2){
  
  return TRUE;/*对单一条件的说明*/
  
  }else{
  
  return isPrime($a);/*其余的条件*/
  
  }
  
  4.4行末注释
  
  注释界定符"//",可以注释掉整行或者一行中的一部分。它一般不用于连续多行的注释文本;然而,它可以用来注释掉连续多行的代码段。以下是所有三种风格的例子:
  
  if($foo>1){
  
  //第二种用法.
  
  ...
  
  }
  
  else{
  
  return false;//说明返回值的原因
  
  }
  
  //if($bar>1){
  
  //
  
  ////第三种用法
  
  //...
  
  //}
  
  //else{
  
  //return false;
  
  //}
  
  4.5文档注释
  
  文档注释描述php的类、构造器,方法,以及字段(field)。每个文档注释都会被置于注释定界符/**...*/之中,一个注释对应一个类或成员。该注释应位于声明之前:
  
  /**
  
  *说明这个类的一些...
  
  */
  
  class Example{...
  
  注意顶层(top-level)的类是不缩进的,而其成员是缩进的。描述类的文档注释的第一行(/**)不需缩进;随后的文档注释每行都缩进1格(使星号纵向对齐)。成员,包括构造函数在内,其文档注释的第一行缩进4格,随后每行都缩进5格。
  
  若你想给出有关类、变量或方法的信息,而这些信息又不适合写在文档中,则可使用实现块注释(见5.1.1)或紧跟在声明后面的单行注释(见5.1.2)。例如,有关一个类实现的细节,应放入紧跟在类声明后面的实现块注释中,而不是放在文档注释中。
  
  文档注释不能放在一个方法或构造器的定义块中,因为程序会将位于文档注释之后的第一个声明与其相关联。

分享到:
本文"都应该看看php标准的注释方法"由远航站长收集整理而来,仅供大家学习与参考使用。更多网站制作教程尽在远航站长站。
顶一下
(0)
0%
踩一下
(0)
0%
[点击 次] [返回上一页] [打印]
发表评论
请自觉遵守互联网相关的政策法规,严禁发布色情、暴力、反动的言论。
评价:
表情:
用户名: 密码: 验证码:
关于本站 - 联系我们 - 网站声明 - 友情连接- 网站地图 - 站点地图 - 返回顶部
Copyright © 2007-2013 www.yhzhan.com(远航站长). All Rights Reserved .
远航站长:为中小站长提供最佳的学习与交流平台,提供网页制作与网站编程等各类网站制作教程.
官方QQ:445490277 网站群:26680406 网站备案号:豫ICP备07500620号-4