<b>Java编程那些事儿20—空白、语句完毕和注释</b>[Java编程]

3.8 空白

在前面的内容中,已经介绍了在编写代码中,单词和单词之间需求利用空格举行隔断,至于空格的数目则不限制.

而实际的编码中,为了使代码的构造清楚,普通需求在代码的前面加入一定数目的空格,比方以下格局:

public class Blank{
　public static void main(String[] args){
　　int n;
　　{
　　　n = 10;
　　}
　　System.out.println(n);
　}
}

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

在实际代码中,只要存在包含关系,则代码就应当缩进,语句块是最典型的包含关系之一.阐明:在编译时,每行开始的空格城市被忽视掉.

3.9 语句完毕

Java语法中,语句以“;”作为行完毕符,比方:

int n = 2;

普通情形下,代码中每行只写一句代码,但是也可以写多句,比方:

int n = 2; byte b = 10;

但是普通为了代码构造清楚,只在一行中书写一句代码.

有些时刻代码本身对比长,则也可以把一句代码写在多行,而代码语句完毕的地方书写一个“;”便可.

在实际代码中,普通大括号开始和完毕的地方,以及大部份小括号完毕的地方都不需求书写“;”来举行完毕.

3.10 注释

注释(comment)是对代码功效和用处的阐明.在程序中编写得当的注释,将使程序代码更简单阅读,加强代码的可保护性.

注释在程序编译时城市被忽视,所以注释不会增添class文件的大小.

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

3.10.1 单行注释

单行注释指只能书写一行的注释.单行注释属于注释中最简单的语法格局,用于关于代码举行简单的阐明,比方变量功效等.

单行注释的语法格局为:

//注释内容

注释以两个斜线开始,该行后续的内容都是注释的内容,注释内容不能换行.

单行注释普通书写在需求阐明的代码的上一行,大概该行代码的完毕处,示例构造以下:

//循环变量

int i = 0;

char sex;//性别

3.10.2 多行注释

多行注释指可以书写肆意多行的注释.多行注释普通用于阐明对比复杂的内容,比方程序逻辑或算法实现原理等.

多行注释的语法格局为:

/*

注释内容

*/

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

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

3.10.3 文档注释

文档注释指可以被提取出来形成程序文档的注释格局,这是Java语言有特点的注释格局.普通关于程序程序的构造举行阐明,比方类、属性、办法和构造办法举行阐明,这些概念在后续将具体介绍.

文档注释的语法格局为:

/**

注释内容

*/

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

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

3.10.4 别的

在标准的代码中,普通有10%-20%的注释,也就是每100行代码中包含10-20行注释的内容,但是国内很多开辟公司都远远达不到这个要求.

别的需求分外注意的是,在实际的项目开辟中,在改正代码后,一定要对应的改正注释的内容,保持代码和注释内容的同步.

文章根源:http://blog.csdn.net/Mailbomb/archive/2008/05/17/2453908.aspx