Java java.lang 类 String（JDK5）

所有类

java.lang
类 String

java.lang.Object
  java.lang.String

所有已实现的接口：

Serializable, CharSequence, Comparable<String>

public final class String
   
   
   
   
   
extends Object
   
   
   
   
   
   
   
   
   
   
implements Serializable, Comparable<String>, CharSequence
   
   
   
   
   

String 类代表字符串。Java 程序中的所有字符串字面值（如 "abc" ）都作为此类的实例来实现。

字符串是常量；它们的值在创建之后不能改变。字符串缓冲区支持可变的字符串。因为 String 对象是不可变的，所以可以共享它们。例如：

     String str = "abc";
 

等效于：

     char data[] = {'a', 'b', 'c'};
     String str = new String(data);
 

下面给出了一些如何使用字符串的更多例子：

     System.out.println("abc");
     String cde = "cde";
     System.out.println("abc" + cde);
     String c = "abc".substring(2,3);
     String d = cde.substring(1, 2);
 

String 类包括的方法有：检查序列的单个字符；比较字符串；搜索字符串；提取子字符串；创建字符串副本，在该副本中，所有的字符都被转换为大写或小写形式。大小写映射基于 Character 类指定的 Unicode Standard 版本。

Java 语言提供对字符串串联符号（"+"）和其他对象到字符串的转换的特殊支持。字符串串联是通过 StringBuilder（或 StringBuffer）类及其 append 方法实现的。字符串转换是通过 toString 方法实现的，该方法由 Object 类定义，并可被 Java 中所有类继承。有关字符串串联和转换的更多信息，请参阅 Gosling、Joy 和 Steele 合著的《The Java Language Specification》。

除非另行说明，否则将 null 参数传递给此类中的构造方法或方法都会抛出 NullPointerException。

String 表示一个 UTF-16 格式的字符串，其中的增补字符 由代理项对 表示（有关详细信息，请参阅 Character 类中的 Unicode 字符表示形式）。索引值是指 char 代码单元，因此增补字符在 String 中占用两个位置。

String 类提供处理 Unicode 代码点（即字符）和 Unicode 代码单元（即 char 值）的方法。

从以下版本开始：

JDK1.0

另请参见：

Object.toString(), StringBuffer, StringBuilder, Charset, 序列化表格

CASE_INSENSITIVE_ORDER

public static final Comparator<String> CASE_INSENSITIVE_ORDER

一个排序 String 对象的 Comparator，它的作用与 compareToIgnoreCase 相同。该比较器是可序列化的。

注意，Comparator 未 考虑到语言环境，因此可能导致在某些语言环境中排序效果不理想。java.text 包提供 Collators 来完成语言环境敏感的排序。

从以下版本开始：

1.2

另请参见：

Collator.compare(String, String)

String

public String()

初始化一个新创建的 String 对象，它表示一个空字符序列。注意，由于 String 是不可变的，不必使用该构造方法。

String

public String(String original)

初始化一个新创建的 String 对象，表示一个与该参数相同的字符序列；换句话说，新创建的字符串是该参数字符串的一个副本。由于 String 是不可变的，不必使用该构造方法，除非需要 original 的显式副本。

参数：

original - 一个 String。

String

public String(char[] value)

分配一个新的 String，它表示当前字符数组参数中包含的字符序列。该字符数组的内容已被复制；后续对字符数组的修改不会影响新创建的字符串。

参数：

value - 此字符串的初始值。

String

public String(char[] value,
              int offset,
              int count)

分配一个新的 String，它包含来自该字符数组参数的一个子数组的字符。offset 参数是子数组第一个字符的索引，count 参数指定子数组的长度。该子数组的内容已被复制；后续对字符数组的修改不会影响新创建的字符串。

参数：

value - 作为字符源的数组。

offset - 初始偏移量。

count - 长度。

抛出：

IndexOutOfBoundsException - 如果 offset 和 count 参数索引字符超出 value 数组的范围。

String

public String(int[] codePoints,
              int offset,
              int count)

分配一个新的 String，它包含该 Unicode 代码点数组参数的一个子数组的字符。offset 参数是该子数组第一个代码点的索引，count 参数指定子数组的长度。将该子数组的内容转换为 char；后续对 int 数组的修改不会影响新创建的字符串。

参数：

codePoints - 作为 Unicode 代码点的源的数组。

offset - 初始偏移量。

count - 长度。

抛出：

IllegalArgumentException - 如果在 codePoints 中发现任何无效的 Unicode 代码点

IndexOutOfBoundsException - 如果 offset 和 count 参数索引字符超出 codePoints 数组的范围。

从以下版本开始：

1.5

String

@Deprecated
public String(byte[] ascii,
                         int hibyte,
                         int offset,
                         int count)

已过时。 该方法无法将字节正确转换为字符。从 JDK 1.1 开始，完成该转换的首选方法是通过 String 构造方法，它接受一个字符集名称，或者使用平台默认的字符集。

分配一个新的 String，它根据一个 8 位整数值数组的子数组构造。

offset 参数是该子数组的第一个字节的索引，count 参数指定子数组的长度。

子数组中的每个 byte 都按照上述方法转换为 char。

参数：

ascii - 要转换为字符的字节。

hibyte - 每个 16 位 Unicode 字符的前 8 位。

offset - 初始偏移量。

count - 长度。

抛出：

IndexOutOfBoundsException - 如果 offset 或 count 参数无效。

另请参见：

String(byte[], int), String(byte[], int, int, java.lang.String), String(byte[], int, int), String(byte[], java.lang.String), String(byte[])

String

@Deprecated
public String(byte[] ascii,
                         int hibyte)

已过时。 该方法无法将字节正确转换为字符。从 JDK 1.1 起，完成该转换的首选方法是通过 String 构造方法，该方法接受一个字符集名称或使用平台的默认字符集。

分配一个新的 String，它包含的字符根据一个 8 位整数值的数组构造。得到的字符串中的每个字符 c 都根据字节数组中的相应部分 b 构造，如下所示：

     c == (char)(((hibyte & 0xff) << 8)
                         | (b & 0xff))
 

参数：

ascii - 要转换为字符的字节。

hibyte - 每个 16 位 Unicode 字符的前 8 位。

另请参见：

String(byte[], int, int, java.lang.String), String(byte[], int, int), String(byte[], java.lang.String), String(byte[])