Chinaunix首页 | 论坛 | 博客
  • 博客访问: 590949
  • 博文数量: 718
  • 博客积分: 4000
  • 博客等级: 上校
  • 技术积分: 4960
  • 用 户 组: 普通用户
  • 注册时间: 2008-10-17 13:24
文章分类

全部博文(718)

文章存档

2011年(1)

2008年(717)

我的朋友

分类:

2008-10-17 13:27:22

    3.8 空白

    在前面的内容中,已经介绍了在编写代码中,单词和单词之间需要使用空格进行间隔,至于空格的数量则不限制。

    而实际的编码中,为了使代码的结构清晰,一般需要在代码的前面加入一定数量的空格,例如如下格式:

    public class Blank{

    public static void main(String[] args){

    int n;

    {

    n = 10;

    }

    System.out.println(n);

    }

    }

    在该代码中,除了第一行和最后一行外,每行都包含一定数量的空格,这种编码的格式称为代码缩进。

    在实际代码中,只要存在包含关系,则代码就应该缩进,语句块是最典型的包含关系之一。说明:在编译时,每行开始的空格都会被忽略掉。

    3.9 语句结束

    语法中,语句以“;”作为行结束符,例如:

    int n = 2;

    通常情况下,代码中每行只写一句代码,但是也可以写多句,例如:

    int n = 2; byte b = 10;

    但是一般为了代码结构清楚,只在一行中书写一句代码。

    有些时候代码本身比较长,则也可以把一句代码写在多行,而代码语句结束的地方书写一个“;”即可。

    在实际代码中,一般大括号开始和结束的地方,以及大部分小括号结束的地方都不需要书写“;”来进行结束。

    3.10 注释

    注释(comment)是对代码功能和用途的说明。在程序中编写适当的注释,将使程序代码更容易阅读,增强代码的可维护性。

    注释在程序编译时都会被忽略,所以注释不会增加class文件的大小。

    语言中注释的语法有三种:单行注释、多行注释和文档注释。

    3.10.1 单行注释

    单行注释指只能书写一行的注释。单行注释属于注释中最简单的语法格式,用于对于代码进行简单的说明,例如变量功能等。

    单行注释的语法格式为://注释内容注释以两个斜线开始,该行后续的内容都是注释的内容,注释内容不能换行。

    单行注释一般书写在需要说明的代码的上一行,或者该行代码的结束处,示例结构如下:

    //循环变量

    int i = 0;

    char sex; //性别

    3.10.2 多行注释

    多行注释指可以书写任意多行的注释。多行注释一般用于说明比较复杂的内容,例如程序逻辑或算法实现原理等。

    多行注释的语法格式为:

    /*

    注释内容

    */

    注释以一个斜线和一个星号开始,后续是注释内容,注释内容可以书写任意多行,最后注释以一个星号和一个斜线结尾。

    很多多行注释在每行以星号开始,这个不是语法必需的。

    3.10.3 文档注释

    文档注释指可以被提取出来形成程序文档的注释格式,这是Java语言有特色的注释格式。一般对于程序程序的结构进行说明,例如类、属性、方法和构造方法进行说明,这些概念在后续将详细介绍。

    文档注释的语法格式为:

    /**

    注释内容*/

    注释以一个斜线和两个星号开始,后续是注释内容,注释内容可以书写任意多行,最后注释以一个星号和一个斜线结尾。

    在后续内容中还将完善该注释的语法格式。

    3.10.4 其它

    在规范的代码中,一般有10%-20%的注释,也就是每100行代码中包含10-20行注释的内容,但是国内很多开发公司都远远达不到这个要求。

    另外需要特别注意的是,在实际的项目开发中,在修改代码后,一定要对应的修改注释的内容,保持代码和注释内容的同步。

【责编:Chuan】

--------------------next---------------------

阅读(342) | 评论(0) | 转发(0) |
给主人留下些什么吧!~~