博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
Java代码注释
阅读量:5286 次
发布时间:2019-06-14

本文共 852 字,大约阅读时间需要 2 分钟。

  通过代码注释,可提高程序的可读性。注释中包含了程序的信息,可以帮助从程序员更好的阅读和理解程序。Java源文件的任意位置都可以添加注释语句。注释的文字Java编译器不进行编译,所有代码中的注释文字对程序不产生影响。Java提供了三种注释方法,分别为单行注释,多行注释,文档注释。

 

  1 单行注释

  “//”为单行注释的符号,从符号“//”开始到换行位置均为注释而被Java编译器忽略。语法如下:

      //注释内容

  例如:以下代码为声明int型变量添加注释。

  int age;    //定义int型变量用于保存年龄信息

 

  2 多行注释

  “/**/”为多行注释标记,符号“/*”与“*/”之间的所有内容都为注释内容。注释中的内容可以】换行。

  语法如下:

  /*

  注释内容1

  注释内容2 

  */

 

  注意

  多行注释中可以嵌套单行,例如:

  /*

  程序名称:hello Word //开发时间为2017年

  */

 

  但是在多行注释中不能嵌套多行注释,例如:

  /*

    程序名称:hello Word

    /*

    开发时间:2017年

    作者:CHEN

    */

  */

  此程序为错误的。

 

  3 文档注释

  “/***/”为文档注释的符号,符号“/**”与符号“*/”之间额内容为注释内容。当文档注释出现在声明变量(如类的声、明类成员变量的声明、类成员方法的声明等)之前时,会被Javadoc文档工读取为Javadoc文档内容。文档注释的格式与多行注释的格式相同,对于初学者而言,文档注释并不是很重要,了解即可。

  

  说明

  一定要养成良好的编程风格,软件编程规范中提到“可读性第一,,效率第二”,所以程序员一定要在编程中添加适量的注释来提高代码的可读性和可维护性。程序中注释要占程序代码总量的20%~50%。

转载于:https://www.cnblogs.com/bigswallow/p/6892896.html

你可能感兴趣的文章
code异常处理
查看>>
git - 搭建最简单的git server
查看>>
会话控制
查看>>
推荐一款UI设计软件Balsamiq Mockups
查看>>
Linux crontab 命令格式与详细例子
查看>>
百度地图Api进阶教程-地图鼠标左右键操作实例和鼠标样式6.html
查看>>
游标使用
查看>>
LLBL Gen Pro 设计器使用指南
查看>>
SetCapture() & ReleaseCapture() 捕获窗口外的【松开左键事件】: WM_LBUTTONUP
查看>>
Android 设置界面的圆角选项
查看>>
百度地图api服务端根据经纬度得到地址
查看>>
根据xml生成相应的对象类
查看>>
Android StageFrightMediaScanner源码解析
查看>>
打包java程序生成exe
查看>>
八叉树
查看>>
Git 远程仓库
查看>>
关于静态文本框透明度的问题
查看>>
javascript的发展及个人笔记
查看>>
全选,反全选,反选,获取选中的值,根据子选择控制全选按钮
查看>>
[CF#250 Div.2 D]The Child and Zoo(并查集)
查看>>