java笔记------文档注释标记，String相关的API

Posted 2020-10-04 yuer629

常用的javadoc标记有以下几种：

[email protected] 程序的作者说明

[email protected] 源文件的版本说明

[email protected] 方法的参数说明

[email protected] 不建议的使用方法

[email protected] 方法的返回值的说明信息

[email protected] 参见，用于指定参考内容

[email protected] 抛出的异常类型

[email protected] 抛出的异常

 

可以出现在类或者接口文档注释中的：@see，@deprecated，@author，@version等

可以出现在方法和构造器中的有： @see，@deprecated，@param，@return，@exception，@throws等

可以出现在成员变量中有：@see，@deprecated等

 

String API

一、获取：

int  length()：获取字符串的长度。

char  charAt( int  index )根据位置获取该位置上某个字符：

根据字符获取该字符在字符串中的位置：

int  indexOf(int ch)：返回的是ch在字符串中第一次出现的的位置。

int  indexOf(int ch,int fromIndex)：从fromIndex指定位置开始，获取ch在字符串中出现的位置。

int  indexOf(String str)：返回的是str在字符串中第一次出现的的位置。

int  indexOf(String str,int fromIndex)：从fromIndex指定位置开始，获取str在字符串中出现的位置。

int  lastIndexOf(xx,xx)：里面的参数与上面的4中方法一致。但是是从后面开始查找。  

 

二、判断：

boolean  contains(str)：字符串中是否包含某一个字符串。

特例indexOf(str)：可以索引str第一次出现位置，如果返回-1，表示该str不在字符串中存在。即用该方法就可以判断是否包含某一个字符串。而且可以返回出现的位置。

boolean  isEmpty()：字符中是否有内容。

boolean  startsWith(str)：字符串是否是以指定内容开头。

boolean  endsWith(str)：字符串是否是以指定内容结尾。

boolean  equals(str)：判断字符串内容是否相等。复写了Object类中的equals()方法。

boolean  equalsIgnoreCase(str)：判断字符串内容是否相同，并忽略大小写。

 

三、转换：

将字符数组转换成字符串。

构造函数String(char [])  将字符数组转换成字符串。

         String(char [],offset,count)  将字符数组中的一部分转换成字符串。

静态方法：static copyValueOf(char [] data)

         static copyValueOf(char [] data,int  offset , int count)         

将字符串转换成字符数组。**

    char []  toCharArray();

将字节数组转换成字符串。

构造函数String(byte [])  将字节数组转换成字符串。

         String(byte [],offset,count)  将字节数组中的一部分转换成字符串。

将字符串转换成字符数组。 

    byte []  getBytes();

将基本数据类型转换成字符串。

static String valueOf(基本数据类型)

特殊注意：字符串和字节数组在转换过程中，是可以指定编码表的。

 

四、替换：

String replace(oldChar,newChar); 如果要替换的字符不存在，则返回的还是原串。单引号。

String replace(oldCharSequence,newCharSequence); 如果要替换字符串不存在，返回原串。双引号。

 

五、切割：

String [] split(regex); 参数为指定的字符串。

 

六、子串：

String substring(begin);  获取字符串中的一部分。从指定的位置开始。

String substring(begin,end);  获取字符串中的一部分。从指定的位置开始，到指定的位置前一位结束

 

其他：

String toUpperCase()：将字符串转换成大写。

String toLowerCase()：将字符串转换成小写。

String trim()：将字符串两端的多个空格去除。

int compareTo(String )对两个字符串进行自然顺序的比较。