JDK帮助文档

JDK帮助文档

ng

类 String

ng.Object

ng.String

所有已实现的接口:

Serializable, CharSequence, Comparable

--------------------------------------------------------------------------------

public final class Stringextends Objectimplements Serializable,

Comparable,

CharSequenceString 类代表字符串。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, 序列化表格

-------------------------------------------------------------------------------- 字段摘要

static Comparator CASE_INSENSITIVE_ORDER

一个排序 String 对象的 Comparator，它的作用与 compareToIgnoreCase 相同。

构造方法摘要

String()

初始化一个新创建的 String 对象，它表示一个空字符序列。

String(byte[] bytes)

构造一个新的 String，方法是使用平台的默认字符集解码字节的指定数组。

String(byte[] ascii, int hibyte)

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

构造一个新的 String，方法是使用指定的字符集解码字节的指定子数组。

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

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

charsetName)

构造一个新的 String，方法是使用指定的字符集解码字节的指定子数组。

String(byte[] bytes, String charsetName)

构造一个新的 String，方法是使用指定的字符集解码指定的字节数组。

String(char[] value) 分配一个新的 String，它表示当前字符数组参数中包含的字符序列。

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

分配一个新的 String，它包含来自该字符数组参数的一个子数组的字符。

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

分配一个新的 String，它包含该 Unicode 代码点数组参数的一个子数组的字符。 String(String original)

初始化一个新创建的 String 对象，表示一个与该参数相同的字符序列;换句话

说，新创建的字符串是该参数字符串的一个副本。

String(StringBuffer buffer)

分配一个新的字符串，它包含当前包含在字符串缓冲区参数中的字符序列。

String(StringBuilder builder)

分配一个新的字符串，它包含当前包含在字符串生成器参数中的字符序列。

方法摘要

char charAt(int index)

返回指定索引处的 char 值。

int codePointAt(int index)

返回指定索引处的字符(Unicode 代码点)。

int codePointBefore(int index)

返回指定索引之前的字符(Unicode 代码点)。

int codePointCount(int beginIndex, int endIndex)

返回此 String 的指定文本范围中的 Unicode 代码点数。

int compareTo(String anotherString)

按字典顺序比较两个字符串。 int compareToIgnoreCase(String str)

不考虑大小写，按字典顺序比较两个字符串。

String concat(String str)

将指定字符串联到此字符串的结尾。

boolean contains(CharSequence s)

当且仅当此字符串包含 char 值的指定序列时，才返回 true。

boolean contentEquals(CharSequence cs)

当且仅当此 String 表示与指定序列相同的 char 值时，才返回 true。

boolean contentEquals(StringBuffer sb)

当且仅当此 String 表示与指定的 StringBuffer 相同的字符序列时，才返回

true。

static String copyValueOf(char[] data)

返回指定数组中表示该字符序列的字符串。

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

返回指定数组中表示该字符序列的字符串。

boolean endsWith(String suffix)

测试此字符串是否以指定的后缀结束。

boolean equals(Object anObject)

比较此字符串与指定的对象。

boolean equalsIgnoreCase(String anotherString)

将此 String 与另一个 String 进行比较，不考虑大小写。 static String

format(Locale l, String format, Object... args)

使用指定的语言环境、格式字符串和参数返回一个格式化字符串。 static

String format(String format, Object... args) 使用指定的格式字符串和参数返回一个格式化字符串。

byte[] getBytes()

使用平台默认的字符集将此 String 解码为字节序列，并将结果存储到一个新的字节数组中。

void getBytes(int srcBegin, int srcEnd, byte[] dst, int dstBegin)

已过时。 该方法无法将字符正确转换为字节。从 JDK 1.1 起，完成该转换的首选方法是通过 getBytes() 构造方法，该方法使用平台的默认字符集。

byte[] getBytes(String charsetName)

使用指定的字符集将此 String 解码为字节序列，并将结果存储到一个新的字节数组中。

void getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin)

将字符从此字符串复制到目标字符数组。

int hashCode()

返回此字符串的哈希码。

int indexOf(int ch)

返回指定字符在此字符串中第一次出现处的索引。

int indexOf(int ch, int fromIndex)

从指定的索引开始搜索，返回在此字符串中第一次出现指定字符处的索引。

int indexOf(String str)

返回第一次出现的指定子字符串在此字符串中的索引。

int indexOf(String str, int fromIndex)

从指定的索引处开始，返回第一次出现的指定子字符串在此字符串中的索引。

String intern()

返回字符串对象的规范化表示形式。