登录后台

页面导航

java.lang 类 String

java.lang.Object
  java.lang.String
  • 所有已实现的接口:

Serializable, CharSequence, Comparable<String>


  • public final class **String**extends Objectimplements 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 标准版。

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<String>**[CASE_INSENSITIVE_ORDER](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#CASE_INSENSITIVE_ORDER)** 一个对 String 对象进行排序的 Comparator,作用与 compareToIgnoreCase 相同。
构造方法摘要
**[String](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#String())**() 初始化一个新创建的 String 对象,使其表示一个空字符序列。
**[String](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#String(byte[]))**(byte[] bytes) 通过使用平台的默认字符集解码指定的 byte 数组,构造一个新的 String
**[String](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#String(byte[], java.nio.charset.Charset))**(byte[] bytes, Charset charset) 通过使用指定的 charset 解码指定的 byte 数组,构造一个新的 String
**[String](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#String(byte[], int))**(byte[] ascii, int hibyte) 已过时。 该方法无法将字节正确地转换为字符。从 JDK 1.1 开始,完成该转换的首选方法是使用带有 Charset、字符集名称,或使用平台默认字符集的 String 构造方法。
**[String](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#String(byte[], int, int))**(byte[] bytes, int offset, int length) 通过使用平台的默认字符集解码指定的 byte 子数组,构造一个新的 String
**[String](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#String(byte[], int, int, java.nio.charset.Charset))**(byte[] bytes, int offset, int length, Charset charset) 通过使用指定的 charset 解码指定的 byte 子数组,构造一个新的 String
**[String](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#String(byte[], int, int, int))**(byte[] ascii, int hibyte, int offset, int count) 已过时。 该方法无法将字节正确地转换为字符。从 JDK 1.1 开始,完成该转换的首选方法是使用带有 Charset、字符集名称,或使用平台默认字符集的 String 构造方法。
**[String](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#String(byte[], int, int, java.lang.String))**(byte[] bytes, int offset, int length, String charsetName) 通过使用指定的字符集解码指定的 byte 子数组,构造一个新的 String
**[String](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#String(byte[], java.lang.String))**(byte[] bytes, String charsetName) 通过使用指定的 charset 解码指定的 byte 数组,构造一个新的 String
**[String](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#String(char[]))**(char[] value) 分配一个新的 String,使其表示字符数组参数中当前包含的字符序列。
**[String](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#String(char[], int, int))**(char[] value, int offset, int count) 分配一个新的 String,它包含取自字符数组参数一个子数组的字符。
**[String](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#String(int[], int, int))**(int[] codePoints, int offset, int count) 分配一个新的 String,它包含 Unicode 代码点数组参数一个子数组的字符。
**[String](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#String(java.lang.String))**(String original) 初始化一个新创建的 String 对象,使其表示一个与参数相同的字符序列;换句话说,新创建的字符串是该参数字符串的副本。
**[String](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#String(java.lang.StringBuffer))**(StringBuffer buffer) 分配一个新的字符串,它包含字符串缓冲区参数中当前包含的字符序列。
**[String](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#String(java.lang.StringBuilder))**(StringBuilder builder) 分配一个新的字符串,它包含字符串生成器参数中当前包含的字符序列。
方法摘要
char**[charAt](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#charAt(int))**(int index) 返回指定索引处的 char 值。
int**[codePointAt](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#codePointAt(int))**(int index) 返回指定索引处的字符(Unicode 代码点)。
int**[codePointBefore](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#codePointBefore(int))**(int index) 返回指定索引之前的字符(Unicode 代码点)。
int**[codePointCount](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#codePointCount(int, int))**(int beginIndex, int endIndex) 返回此 String 的指定文本范围中的 Unicode 代码点数。
int**[compareTo](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#compareTo(java.lang.String))**(String anotherString) 按字典顺序比较两个字符串。
int**[compareToIgnoreCase](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#compareToIgnoreCase(java.lang.String))**(String str) 按字典顺序比较两个字符串,不考虑大小写。
String**[concat](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#concat(java.lang.String))**(String str) 将指定字符串连接到此字符串的结尾。
boolean**[contains](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#contains(java.lang.CharSequence))**(CharSequence s) 当且仅当此字符串包含指定的 char 值序列时,返回 true。
boolean**[contentEquals](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#contentEquals(java.lang.CharSequence))**(CharSequence cs) 将此字符串与指定的 CharSequence 比较。
boolean**[contentEquals](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#contentEquals(java.lang.StringBuffer))**(StringBuffer sb) 将此字符串与指定的 StringBuffer 比较。
static String**[copyValueOf](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#copyValueOf(char[]))**(char[] data) 返回指定数组中表示该字符序列的 String。
static String**[copyValueOf](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#copyValueOf(char[], int, int))**(char[] data, int offset, int count) 返回指定数组中表示该字符序列的 String。
boolean**[endsWith](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#endsWith(java.lang.String))**(String suffix) 测试此字符串是否以指定的后缀结束。
boolean**[equals](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#equals(java.lang.Object))**(Object anObject) 将此字符串与指定的对象比较。
boolean**[equalsIgnoreCase](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#equalsIgnoreCase(java.lang.String))**(String anotherString) 将此 String 与另一个 String 比较,不考虑大小写。
static String**[format](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#format(java.util.Locale, java.lang.String, java.lang.Object...))**(Locale l, String format, Object... args) 使用指定的语言环境、格式字符串和参数返回一个格式化字符串。
static String**[format](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#format(java.lang.String, java.lang.Object...))**(String format, Object... args) 使用指定的格式字符串和参数返回一个格式化字符串。
byte[]**[getBytes](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#getBytes())**() 使用平台的默认字符集将此 String 编码为 byte 序列,并将结果存储到一个新的 byte 数组中。
byte[]**[getBytes](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#getBytes(java.nio.charset.Charset))**(Charset charset) 使用给定的 charset 将此 String 编码到 byte 序列,并将结果存储到新的 byte 数组。
void**[getBytes](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#getBytes(int, int, byte[], int))**(int srcBegin, int srcEnd, byte[] dst, int dstBegin) 已过时。 该方法无法将字符正确转换为字节。从 JDK 1.1 起,完成该转换的首选方法是通过 getBytes()) 方法,该方法使用平台的默认字符集。
byte[]**[getBytes](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#getBytes(java.lang.String))**(String charsetName) 使用指定的字符集将此 String 编码为 byte 序列,并将结果存储到一个新的 byte 数组中。
void**[getChars](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#getChars(int, int, char[], int))**(int srcBegin, int srcEnd, char[] dst, int dstBegin) 将字符从此字符串复制到目标字符数组。
int**[hashCode](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#hashCode())**() 返回此字符串的哈希码。
int**[indexOf](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#indexOf(int))**(int ch) 返回指定字符在此字符串中第一次出现处的索引。
int**[indexOf](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#indexOf(int, int))**(int ch, int fromIndex) 返回在此字符串中第一次出现指定字符处的索引,从指定的索引开始搜索。
int**[indexOf](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#indexOf(java.lang.String))**(String str) 返回指定子字符串在此字符串中第一次出现处的索引。
int**[indexOf](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#indexOf(java.lang.String, int))**(String str, int fromIndex) 返回指定子字符串在此字符串中第一次出现处的索引,从指定的索引开始。
String**[intern](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#intern())**() 返回字符串对象的规范化表示形式。
boolean**[isEmpty](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#isEmpty())**() 当且仅当 length()) 为 0 时返回 true
int**[lastIndexOf](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#lastIndexOf(int))**(int ch) 返回指定字符在此字符串中最后一次出现处的索引。
int**[lastIndexOf](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#lastIndexOf(int, int))**(int ch, int fromIndex) 返回指定字符在此字符串中最后一次出现处的索引,从指定的索引处开始进行反向搜索。
int**[lastIndexOf](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#lastIndexOf(java.lang.String))**(String str) 返回指定子字符串在此字符串中最右边出现处的索引。
int**[lastIndexOf](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#lastIndexOf(java.lang.String, int))**(String str, int fromIndex) 返回指定子字符串在此字符串中最后一次出现处的索引,从指定的索引开始反向搜索。
int**[length](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#length())**() 返回此字符串的长度。
boolean**[matches](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#matches(java.lang.String))**(String regex) 告知此字符串是否匹配给定的正则表达式
int**[offsetByCodePoints](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#offsetByCodePoints(int, int))**(int index, int codePointOffset) 返回此 String 中从给定的 index 处偏移 codePointOffset 个代码点的索引。
boolean**[regionMatches](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#regionMatches(boolean, int, java.lang.String, int, int))**(boolean ignoreCase, int toffset, String other, int ooffset, int len) 测试两个字符串区域是否相等。
boolean**[regionMatches](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#regionMatches(int, java.lang.String, int, int))**(int toffset, String other, int ooffset, int len) 测试两个字符串区域是否相等。
String**[replace](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#replace(char, char))**(char oldChar, char newChar) 返回一个新的字符串,它是通过用 newChar 替换此字符串中出现的所有 oldChar 得到的。
String**[replace](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#replace(java.lang.CharSequence, java.lang.CharSequence))**(CharSequence target, CharSequence replacement) 使用指定的字面值替换序列替换此字符串所有匹配字面值目标序列的子字符串。
String**[replaceAll](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#replaceAll(java.lang.String, java.lang.String))**(String regex, String replacement) 使用给定的 replacement 替换此字符串所有匹配给定的正则表达式的子字符串。
String**[replaceFirst](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#replaceFirst(java.lang.String, java.lang.String))**(String regex, String replacement) 使用给定的 replacement 替换此字符串匹配给定的正则表达式的第一个子字符串。
String[]**[split](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#split(java.lang.String))**(String regex) 根据给定正则表达式的匹配拆分此字符串。
String[]**[split](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#split(java.lang.String, int))**(String regex, int limit) 根据匹配给定的正则表达式来拆分此字符串。
boolean**[startsWith](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#startsWith(java.lang.String))**(String prefix) 测试此字符串是否以指定的前缀开始。
boolean**[startsWith](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#startsWith(java.lang.String, int))**(String prefix, int toffset) 测试此字符串从指定索引开始的子字符串是否以指定前缀开始。
CharSequence**[subSequence](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#subSequence(int, int))**(int beginIndex, int endIndex) 返回一个新的字符序列,它是此序列的一个子序列。
String**[substring](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#substring(int))**(int beginIndex) 返回一个新的字符串,它是此字符串的一个子字符串。
String**[substring](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#substring(int, int))**(int beginIndex, int endIndex) 返回一个新字符串,它是此字符串的一个子字符串。
char[]**[toCharArray](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#toCharArray())**() 将此字符串转换为一个新的字符数组。
String**[toLowerCase](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#toLowerCase())**() 使用默认语言环境的规则将此 String 中的所有字符都转换为小写。
String**[toLowerCase](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#toLowerCase(java.util.Locale))**(Locale locale) 使用给定 Locale 的规则将此 String 中的所有字符都转换为小写。
String**[toString](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#toString())**() 返回此对象本身(它已经是一个字符串!)。
String**[toUpperCase](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#toUpperCase())**() 使用默认语言环境的规则将此 String 中的所有字符都转换为大写。
String**[toUpperCase](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#toUpperCase(java.util.Locale))**(Locale locale) 使用给定 Locale 的规则将此 String 中的所有字符都转换为大写。
String**[trim](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#trim())**() 返回字符串的副本,忽略前导空白和尾部空白。
static String**[valueOf](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#valueOf(boolean))**(boolean b) 返回 boolean 参数的字符串表示形式。
static String**[valueOf](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#valueOf(char))**(char c) 返回 char 参数的字符串表示形式。
static String**[valueOf](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#valueOf(char[]))**(char[] data) 返回 char 数组参数的字符串表示形式。
static String**[valueOf](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#valueOf(char[], int, int))**(char[] data, int offset, int count) 返回 char 数组参数的特定子数组的字符串表示形式。
static String**[valueOf](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#valueOf(double))**(double d) 返回 double 参数的字符串表示形式。
static String**[valueOf](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#valueOf(float))**(float f) 返回 float 参数的字符串表示形式。
static String**[valueOf](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#valueOf(int))**(int i) 返回 int 参数的字符串表示形式。
static String**[valueOf](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#valueOf(long))**(long l) 返回 long 参数的字符串表示形式。
static String**[valueOf](https://www.runoob.com/manual/jdk1.6/java/lang/String.html#valueOf(java.lang.Object))**(Object obj) 返回 Object 参数的字符串表示形式。
从类 java.lang.Object 继承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

字段详细信息

CASE_INSENSITIVE_ORDER

public static final Comparator<String> CASE_INSENSITIVE_ORDER

构造方法详细信息

String

public String()

String

public String(String original)

String

public String(char[] value)

String

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

String

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

String

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

String

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

String

public String(byte[] bytes,
              int offset,
              int length,
              String charsetName)
       throws UnsupportedEncodingException

String

public String(byte[] bytes,
              int offset,
              int length,
              Charset charset)

String

public String(byte[] bytes,
              String charsetName)
       throws UnsupportedEncodingException

String

public String(byte[] bytes,
              Charset charset)

String

public String(byte[] bytes,
              int offset,
              int length)

String

public String(byte[] bytes)

String

public String(StringBuffer buffer)

String

public String(StringBuilder builder)

方法详细信息

length

public int length()

isEmpty

public boolean isEmpty()

charAt

public char charAt(int index)

codePointAt

public int codePointAt(int index)

codePointBefore

public int codePointBefore(int index)

codePointCount

public int codePointCount(int beginIndex,
                          int endIndex)

offsetByCodePoints

public int offsetByCodePoints(int index,
                              int codePointOffset)

getChars

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

getBytes

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

getBytes

public byte[] getBytes(String charsetName)
                throws UnsupportedEncodingException

getBytes

public byte[] getBytes(Charset charset)

getBytes

public byte[] getBytes()

equals

public boolean equals(Object anObject)

contentEquals

public boolean contentEquals(StringBuffer sb)

contentEquals

public boolean contentEquals(CharSequence cs)

equalsIgnoreCase

public boolean equalsIgnoreCase(String anotherString)

compareTo

public int compareTo(String anotherString)

compareToIgnoreCase

public int compareToIgnoreCase(String str)

regionMatches

public boolean regionMatches(int toffset,
                             String other,
                             int ooffset,
                             int len)

regionMatches

public boolean regionMatches(boolean ignoreCase,
                             int toffset,
                             String other,
                             int ooffset,
                             int len)

startsWith

public boolean startsWith(String prefix,
                          int toffset)

startsWith

public boolean startsWith(String prefix)

endsWith

public boolean endsWith(String suffix)

hashCode

public int hashCode()

indexOf

public int indexOf(int ch)

indexOf

public int indexOf(int ch,
                   int fromIndex)

lastIndexOf

public int lastIndexOf(int ch)

lastIndexOf

public int lastIndexOf(int ch,
                       int fromIndex)

indexOf

public int indexOf(String str)

indexOf

public int indexOf(String str,
                   int fromIndex)

lastIndexOf

public int lastIndexOf(String str)

lastIndexOf

public int lastIndexOf(String str,
                       int fromIndex)

substring

public String substring(int beginIndex)

substring

public String substring(int beginIndex,
                        int endIndex)

subSequence

public CharSequence subSequence(int beginIndex,
                                int endIndex)

concat

public String concat(String str)

replace

public String replace(char oldChar,
                      char newChar)

matches

public boolean matches(String regex)

contains

public boolean contains(CharSequence s)

replaceFirst

public String replaceFirst(String regex,
                           String replacement)

replaceAll

public String replaceAll(String regex,
                         String replacement)

replace

public String replace(CharSequence target,
                      CharSequence replacement)

split

public String[] split(String regex,
                      int limit)

split

public String[] split(String regex)

toLowerCase

public String toLowerCase(Locale locale)

toLowerCase

public String toLowerCase()

toUpperCase

public String toUpperCase(Locale locale)

toUpperCase

public String toUpperCase()

trim

public String trim()

toString

public String toString()

toCharArray

public char[] toCharArray()

format

public static String format(String format,
                            Object... args)

format

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

valueOf

public static String valueOf(Object obj)

valueOf

public static String valueOf(char[] data)

valueOf

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

copyValueOf

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

copyValueOf

public static String copyValueOf(char[] data)

valueOf

public static String valueOf(boolean b)

valueOf

public static String valueOf(char c)

valueOf

public static String valueOf(int i)

valueOf

public static String valueOf(long l)

valueOf

public static String valueOf(float f)

valueOf

public static String valueOf(double d)

intern

public String intern()