7.1.5　PL/SQL中的注释

提高代码可读性的最有效的办法就是添加注释。工作中修改其他开发人员的程序是很常见的事，程序如果没有注释，就会很难理解，这样导致的结果轻则会影响修改进度，重则会影响程序开发进度，可见注释对程序是多么重要。通常情况下，程序的注释要求不能低于代码量的20%，注释也是程序的一部分，所以开发人员要养成添加注释的好习惯。

有注释的程序能使阅读者快速地了解代码实现的业务逻辑，并能理解程序的思路。这对自己和其他的开发人员都是很有利的，甚至对公司来讲都是利远大于弊。Oracle为使用者提供了两种注释方式，它们分别是：

❑单行注释：使用“__”两个短划线，可以注释掉后面的语句。

❑多行注释：使用“/…/”，可以注释掉这两部分包含的部分。

【示例4】注释使用方式示例

示例演示如何在一段程序中使用注释。脚本如下：

01 DECLARE

02 v_productprice VARCHAR2(12);—平均价格

03 BEGIN

04 /*

05 利用AVG函数得到价格为3000以上的产品的平均价格

06 */

07 SELECT AVG(PRODUCTPRICE)INTO v_productprice

08 FROM PRODUCTINFO

09 WHERE PRODUCTPRICE＞3000;

10 DBMS_OUTPUT.PUT_LINE('平均价格是：'||v_productprice);—输出语句

11 END;

12 /

【代码解析】

❑第2行和第1 0行后面部分是单行注释。

❑第4～6行部分是多行注释。

【执行效果】

在SQL*Plus中执行脚本，效果见图7.5。

图　7.5　有注释的程序执行效果

从图7.5中可以看出，注释对程序的正确执行没有任何的影响，只是提高了程序的可读性。所以，在开发程序的时候应该添加适当的注释，以方便自己或他人阅读。