Most visited

Recently visited

Added in API level 1

String

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

java.lang.Object
   ↳ java.lang.String


String类表示字符串。 Java程序中的所有字符串文字(例如"abc" )都作为"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定义, Object Java中的所有类继承。 有关字符串连接和转换的更多信息,请参阅Gosling,Joy和Steele, Java语言规范

除非另有说明,否则将 null参数传递给 此类中的构造函数或方法将导致引发 NullPointerException

String表示,其中补充字符代理对表示的UTF-16格式的字符串(请参见第Unicode Character RepresentationsCharacter以获取更多信息类)。 索引值涉及char代码单元,因此补充字符在String使用两个位置。

String类除了处理Unicode代码单元(即 char值)之外,还提供了处理Unicode代码点(即字符)的方法。

也可以看看:

Summary

Fields

public static final Comparator<String> CASE_INSENSITIVE_ORDER

一个比较器,按 compareToIgnoreCase命令 String对象。

Public constructors

String()

初始化新创建的 String对象,以便它表示空字符序列。

String(String original)

初始化新创建的String对象,以便它表示与参数相同的字符序列; 换句话说,新创建的字符串是参数字符串的副本。

String(char[] value)

分配新的 String以便它表示当前包含在字符数组参数中的字符序列。

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

分配包含字符数组参数的子数组中的字符的新的 String

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

分配一个新的 String ,其中包含 Unicode code point数组参数的子阵列中的 字符

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

此构造函数在API级别1中已弃用。此方法不会将字节正确转换为字符。 从JDK 1.1开始,执行此操作的首选方法是使用String构造函数,该构造函数采用Charset ,字符集名称或使用平台默认字符集的构造函数。

String(byte[] ascii, int hibyte)

此构造函数在API级别1中已弃用。此方法不会将字节正确转换为字符。 从JDK 1.1开始,执行此操作的首选方法是使用String构造函数,该构造函数采用Charset ,字符集名称或使用平台默认字符集的构造函数。

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

通过使用指定的字符集解码指定的字节子 String构造一个新的 String

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

通过使用指定的 charset解码指定的字节子 String来构造新的 String

String(byte[] bytes, String charsetName)

构造一个新的 String由指定用指定的字节的数组解码 charset

String(byte[] bytes, Charset charset)

构造一个新的 String由指定用指定的字节的数组解码 charset

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

通过使用平台的默认字符集解码指定的字节子 String构建新的 String

String(byte[] bytes)

通过使用平台的默认字符集解码指定的字节数组构建新的 String

String(StringBuffer buffer)

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

String(StringBuilder builder)

分配一个新字符串,其中包含当前包含在字符串构建器参数中的字符序列。

Public methods

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(StringBuffer sb)

将该字符串与指定的 StringBuffer

boolean contentEquals(CharSequence cs)

将此字符串与指定的 CharSequence

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

返回一个字符串,它表示指定数组中的字符序列。

static String copyValueOf(char[] data)

返回一个字符串,它表示指定数组中的字符序列。

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 charsetName)

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

byte[] getBytes()

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

byte[] getBytes(Charset charset)

使用给定的 charset将此 String编码为一个字节序列,将结果存储到新的字节数组中。

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

此方法在API级别1中已弃用。此方法未正确地将字符转换为字节。 从JDK 1.1开始,首选的方法是通过getBytes()方法,该方法使用平台的默认字符集。

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

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

int hashCode()

返回此字符串的哈希码。

int indexOf(int ch, int fromIndex)

返回指定字符首次出现的此字符串内的索引,从指定索引处开始搜索。

int indexOf(String str)

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

int indexOf(int ch)

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

int indexOf(String str, int fromIndex)

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

String intern()

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

boolean isEmpty()

返回 true,当且仅当, length()0。

int lastIndexOf(int ch)

返回指定字符最后一次出现的字符串中的索引。

int lastIndexOf(String str, int fromIndex)

返回指定子串的最后一次出现的此字符串中的索引,从指定索引开始向后搜索。

int lastIndexOf(String str)

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

int lastIndexOf(int ch, int fromIndex)

返回指定字符最后一次出现的此字符串中的索引,从指定索引开始向后搜索。

int length()

返回此字符串的长度。

boolean matches(String regex)

告诉这个字符串是否与给定的 regular expression匹配。

int offsetByCodePoints(int index, int codePointOffset)

返回此 String内的索引,该索引与给定的 codePointOffset码位的偏移量 index codePointOffset

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

测试两个字符串区域是否相等。

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

测试两个字符串区域是否相等。

String replace(CharSequence target, CharSequence replacement)

将此字符串的每个子字符串替换为指定的文字替换序列的文字目标序列。

String replace(char oldChar, char newChar)

返回从更换所有出现而产生的新的字符串 oldChar ,在这个字符串 newChar

String replaceAll(String regex, String replacement)

用给定的替换替换与给定的 regular expression相匹配的该字符串的每个子字符串。

String replaceFirst(String regex, String replacement)

用给定的替换替换此字符串的第一个子字符串,该字符串与给定的 regular expression匹配。

String[] split(String regex, int limit)

将此字符串拆分为给定的 regular expression

String[] split(String regex)

将该字符串拆分为给定的 regular expression的匹配

boolean startsWith(String prefix)

测试此字符串是否以指定的前缀开头。

boolean startsWith(String prefix, int toffset)

测试从指定索引处开始的此字符串的子字符串是否以指定的前缀开头。

CharSequence subSequence(int beginIndex, int endIndex)

返回一个新的字符序列,该序列是该序列的子序列。

String substring(int beginIndex, int endIndex)

返回一个新字符串,该字符串是此字符串的一个子字符串。

String substring(int beginIndex)

返回一个新字符串,该字符串是此字符串的一个子字符串。

char[] toCharArray()

将此字符串转换为新的字符数组。

String toLowerCase()

使用默认语言环境的规则将此 String所有字符转换为小写字母。

String toLowerCase(Locale locale)

使用给定的 Locale的规则将此 String所有字符转换为 Locale

String toString()

这个对象(它已经是一个字符串!)本身返回。

String toUpperCase(Locale locale)

使用给定的 Locale的规则将此 String所有字符转换为大写。

String toUpperCase()

使用默认语言环境的规则将此 String所有字符转换为大写。

String trim()

返回字符串的副本,省略前导和尾随空白。

static String valueOf(boolean b)

返回 boolean参数的字符串表示形式。

static String valueOf(double d)

返回 double参数的字符串表示形式。

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

返回 char数组参数的特定子阵列的字符串表示形式。

static String valueOf(float f)

返回 float参数的字符串表示形式。

static String valueOf(int i)

返回参数 int的字符串表示形式。

static String valueOf(char c)

返回 char参数的字符串表示形式。

static String valueOf(long l)

返回 long参数的字符串表示形式。

static String valueOf(Object obj)

返回 Object参数的字符串表示形式。

static String valueOf(char[] data)

返回 char数组参数的字符串表示形式。

Inherited methods

From class java.lang.Object
From interface java.lang.Comparable
From interface java.lang.CharSequence

Fields

CASE_INSENSITIVE_ORDER

Added in API level 1
Comparator<String> CASE_INSENSITIVE_ORDER

一个比较器,用compareToIgnoreCase命令String对象。 这个比较器是可串行化的。

请注意,此比较器考虑区域设置,并且会导致某些语言环境的排序不令人满意。 java.text包提供Collators以允许区域设置敏感的排序。

也可以看看:

Public constructors

String

Added in API level 1
String ()

初始化新创建的String对象,以便它表示一个空字符序列。 请注意,由于字符串是不可变的,因此不需要使用此构造函数。

String

Added in API level 1
String (String original)

初始化新创建的String对象,以便它表示与参数相同的字符序列; 换句话说,新创建的字符串是参数字符串的副本。 除非需要显式拷贝original ,否则不需要使用此构造函数,因为字符串是不可变的。

Parameters
original String: A String

String

Added in API level 1
String (char[] value)

分配新的String以便它表示当前包含在字符数组参数中的字符序列。 字符数组的内容被复制; 字符数组的后续修改不会影响新创建的字符串。

Parameters
value char: The initial value of the string

String

Added in API level 1
String (char[] value, 
                int offset, 
                int count)

分配包含字符数组参数的子数组中的字符的新的String offset参数是子count的第一个字符的索引,而count参数指定子count的长度。 子数组的内容被复制; 字符数组的后续修改不会影响新创建的字符串。

Parameters
value char: Array that is the source of characters
offset int: The initial offset
count int: The length
Throws
IndexOutOfBoundsException If the offset and count arguments index characters outside the bounds of the value array

String

Added in API level 1
String (int[] codePoints, 
                int offset, 
                int count)

分配一个新的String ,其中包含Unicode code point数组参数的子阵列中的字符 offset参数是子count的第一个代码点的索引,而count参数指定子count的长度。 子阵列的内容转换为char s; 随后对int数组进行的修改不会影响新创建的字符串。

Parameters
codePoints int: Array that is the source of Unicode code points
offset int: The initial offset
count int: The length
Throws
IllegalArgumentException If any invalid Unicode code point is found in codePoints
IndexOutOfBoundsException If the offset and count arguments index characters outside the bounds of the codePoints array

String

Added in API level 1
String (byte[] ascii, 
                int hibyte, 
                int offset, 
                int count)

此构造函数在API级别1中已弃用。
此方法不能正确地将字节转换为字符。 从JDK 1.1开始,执行此操作的首选方法是使用String构造函数,该构造函数采用Charset ,字符集名称或使用平台的默认字符集。

分配由8位整数值数组的子阵列构造的新的 String

offset参数是子 count的第一个字节的索引,而 count参数指定子 count的长度。

byte中的每个 byte按照上述方法中的指定转换为 char

Parameters
ascii byte: The bytes to be converted to characters
hibyte int: The top 8 bits of each 16-bit Unicode code unit
offset int: The initial offset
count int: The length
Throws
IndexOutOfBoundsException If the offset or count argument is invalid

也可以看看:

String

Added in API level 1
String (byte[] ascii, 
                int hibyte)

此构造函数在API级别1中已弃用。
此方法不能正确地将字节转换为字符。 从JDK 1.1开始,执行此操作的首选方法是使用String构造函数,该构造函数使用Charset ,字符集名称或使用平台的默认字符集。

分配一个新的String其中包含由8位整数值数组String的字符。 结果字符串中的每个字符c都是由字节数组中的对应组件b构造的,因此:

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

Parameters
ascii byte: The bytes to be converted to characters
hibyte int: The top 8 bits of each 16-bit Unicode code unit

也可以看看:

String

Added in API level 1
String (byte[] bytes, 
                int offset, 
                int length, 
                String charsetName)

通过使用指定的字符集解码指定的字节子String来构造新的String 新的String的长度是字符集的函数,因此可能不等于子String的长度。

给定字节在给定字符集中无效时,此构造函数的行为未指定。 当需要对解码过程进行更多控制时,应该使用CharsetDecoder类。

Parameters
bytes byte: The bytes to be decoded into characters
offset int: The index of the first byte to decode
length int: The number of bytes to decode
charsetName String: The name of a supported charset
Throws
UnsupportedEncodingException If the named charset is not supported
IndexOutOfBoundsException If the offset and length arguments index characters outside the bounds of the bytes array

String

Added in API level 9
String (byte[] bytes, 
                int offset, 
                int length, 
                Charset charset)

通过使用指定的charset解码指定的字节子String来构造新的String 新的String的长度是字符集的函数,因此可能不等于子String的长度。

此方法始终用此字符集的默认替换字符串替换格式错误的输入和不可映射字符序列。 当需要对解码过程进行更多的控制时,应该使用CharsetDecoder类。

Parameters
bytes byte: The bytes to be decoded into characters
offset int: The index of the first byte to decode
length int: The number of bytes to decode
charset Charset: The charset to be used to decode the bytes
Throws
IndexOutOfBoundsException If the offset and length arguments index characters outside the bounds of the bytes array

String

Added in API level 1
String (byte[] bytes, 
                String charsetName)

构造一个新的String由指定用指定的字节的数组解码charset 新的String的长度是字符集的函数,因此可能不等于字节数组的长度。

给定字节在给定字符集中无效时,此构造函数的行为未指定。 当需要对解码过程进行更多的控制时,应该使用CharsetDecoder类。

Parameters
bytes byte: The bytes to be decoded into characters
charsetName String: The name of a supported charset
Throws
UnsupportedEncodingException If the named charset is not supported

String

Added in API level 9
String (byte[] bytes, 
                Charset charset)

构造一个新的String由指定用指定的字节的数组解码charset 新的String的长度是字符集的函数,因此可能不等于字节数组的长度。

此方法始终用此字符集的默认替换字符串替换格式错误的输入和不可映射字符序列。 当需要对解码过程进行更多控制时,应该使用CharsetDecoder类。

Parameters
bytes byte: The bytes to be decoded into characters
charset Charset: The charset to be used to decode the bytes

String

Added in API level 1
String (byte[] bytes, 
                int offset, 
                int length)

通过使用平台的默认字符集解码指定的字节子String构建新的String 新的String的长度是字符集的函数,因此可能不等于子String的长度。

当给定字节在默认字符集中无效时,此构造函数的行为未指定。 当需要对解码过程进行更多的控制时,应该使用CharsetDecoder类。

Parameters
bytes byte: The bytes to be decoded into characters
offset int: The index of the first byte to decode
length int: The number of bytes to decode
Throws
IndexOutOfBoundsException If the offset and the length arguments index characters outside the bounds of the bytes array

String

Added in API level 1
String (byte[] bytes)

通过使用平台的默认字符集解码指定的字节数组构建新的String 新的String的长度是charset的函数,因此可能不等于字节数组的长度。

当给定字节在默认字符集中无效时,此构造函数的行为未指定。 当需要对解码过程进行更多控制时,应该使用CharsetDecoder类。

Parameters
bytes byte: The bytes to be decoded into characters

String

Added in API level 1
String (StringBuffer buffer)

分配一个新字符串,其中包含当前包含在字符串缓冲区参数中的字符序列。 字符串缓冲区的内容被复制; 随后修改字符串缓冲区不会影响新创建的字符串。

Parameters
buffer StringBuffer: A StringBuffer

String

Added in API level 1
String (StringBuilder builder)

分配一个新字符串,其中包含当前包含在字符串构建器参数中的字符序列。 字符串生成器的内容被复制; 随后对字符串生成器的修改不会影响新创建的字符串。

提供此构造函数可轻松迁移到StringBuilder 通过toString方法从字符串构建器获取字符串可能运行得更快,通常是首选。

Parameters
builder StringBuilder: A StringBuilder

Public methods

charAt

Added in API level 1
char charAt (int index)

返回指定索引处的值char 索引范围从0length() - 1 序列的第一个char值位于索引0 ,下一个位于索引1 ,依此类推,与数组索引相同。

如果索引指定的 char值为 surrogate ,则返回代理值。

Parameters
index int: the index of the char value.
Returns
char the char value at the specified index of this string. The first char value is at index 0.
Throws
IndexOutOfBoundsException if the index argument is negative or not less than the length of this string.

codePointAt

Added in API level 1
int codePointAt (int index)

返回指定索引处的字符(Unicode码点)。 该索引是指char值(Unicode代码单元),范围从0length() - 1

如果给定索引处指定的char值处于高代理范围内,则以下索引小于此String的长度,并且以下索引处的char值位于低代理范围内,则补充代码点对应于这个代理对被返回。 否则,返回给定索引处的char值。

Parameters
index int: the index to the char values
Returns
int the code point value of the character at the index
Throws
IndexOutOfBoundsException if the index argument is negative or not less than the length of this string.

codePointBefore

Added in API level 1
int codePointBefore (int index)

返回指定索引之前的字符(Unicode码点)。 该索引是指char值(Unicode代码单元),范围从1length

如果char在值(index - 1)处于低代理项范围, (index - 2)不为负,并且char在值(index - 2)处于高代理项范围,则返回代理对的补充代码点值。 如果char值为index - 1是未配对的低代理或高代理,则返回替代值。

Parameters
index int: the index following the code point that should be returned
Returns
int the Unicode code point value before the given index.
Throws
IndexOutOfBoundsException if the index argument is less than 1 or greater than the length of this string.

codePointCount

Added in API level 1
int codePointCount (int beginIndex, 
                int endIndex)

返回此String的指定文本范围内的Unicode代码点数。 文本范围始于指定beginIndex并延伸到char在索引endIndex - 1 因此,文本范围的长度( char s)为endIndex-beginIndex 文本范围内的不配对代理每个计为一个代码点。

Parameters
beginIndex int: the index to the first char of the text range.
endIndex int: the index after the last char of the text range.
Returns
int the number of Unicode code points in the specified text range
Throws
IndexOutOfBoundsException if the beginIndex is negative, or endIndex is larger than the length of this String, or beginIndex is larger than endIndex.

compareTo

Added in API level 1
int compareTo (String anotherString)

按字母顺序比较两个字符串。 该比较基于字符串中每个字符的Unicode值。 由此String对象表示的字符序列按字典顺序与参数字符串表示的字符序列进行比较。 如果这个String对象按照字典顺序String在参数字符串之前,那么结果是一个负整数。 如果这个String对象按照字典顺序跟随参数字符串,那么结果是一个正整数。 如果字符串相等,结果为零; compareTo正好在equals(Object)方法返回0时返回true

这是词典排序的定义。 如果两个字符串不同,那么它们在某个索引处具有不同的字符,这是两个字符串的有效索引,或者它们的长度不同,或者两者都有。 如果它们在一个或多个索引位置具有不同的字符,则令k为最小的这样的索引; 那么位置k处的字符具有较小值的字符串,通过使用<运算符确定,按字典顺序排列在另一个字符串之前。 在这种情况下, compareTo返回两个字符串中位置为k的两个字符值的k - 即值:

 this.charAt(k)-anotherString.charAt(k)
 
If there is no index position at which they differ, then the shorter string lexicographically precedes the longer string. In this case, compareTo returns the difference of the lengths of the strings -- that is, the value:
 this.length()-anotherString.length()
 

Parameters
anotherString String: the String to be compared.
Returns
int the value 0 if the argument string is equal to this string; a value less than 0 if this string is lexicographically less than the string argument; and a value greater than 0 if this string is lexicographically greater than the string argument.

compareToIgnoreCase

Added in API level 1
int compareToIgnoreCase (String str)

按字母顺序比较两个字符串,忽略大小写差异。 此方法返回一个整数,其符号为调用compareTo的字符串的标准化版本,其中通过在每个字符上调用Character.toLowerCase(Character.toUpperCase(character))来消除案例差异。

请注意,此方法场所考虑,并会导致特定的语言环境不满意的排序。 java.text包提供collators以允许区域设置敏感的排序。

Parameters
str String: the String to be compared.
Returns
int a negative integer, zero, or a positive integer as the specified String is greater than, equal to, or less than this String, ignoring case considerations.

也可以看看:

concat

Added in API level 1
String concat (String str)

将指定的字符串连接到此字符串的末尾。

如果参数字符串的长度为0 ,则返回此String对象。 否则,新String对象被创建,代表一个字符序列,它是由该表示的字符序列的级联String对象和由参数字符串表示的字符序列。

例子:

 "cares".concat("s") returns "caress"
 "to".concat("get").concat("her") returns "together"
 

Parameters
str String: the String that is concatenated to the end of this String.
Returns
String a string that represents the concatenation of this object's characters followed by the string argument's characters.

contains

Added in API level 1
boolean contains (CharSequence s)

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

Parameters
s CharSequence: the sequence to search for
Returns
boolean true if this string contains s, false otherwise
Throws
NullPointerException if s is null

contentEquals

Added in API level 1
boolean contentEquals (StringBuffer sb)

将此字符串与指定的StringBuffer 其结果是true ,如果,如果这仅String表示字符作为指定的相同序列StringBuffer

Parameters
sb StringBuffer: The StringBuffer to compare this String against
Returns
boolean true if this String represents the same sequence of characters as the specified StringBuffer, false otherwise

contentEquals

Added in API level 1
boolean contentEquals (CharSequence cs)

将该字符串与指定的CharSequence 当且仅当此String表示与指定序列相同的char值序列时,结果为true

Parameters
cs CharSequence: The sequence to compare this String against
Returns
boolean true if this String represents the same sequence of char values as the specified sequence, false otherwise

copyValueOf

Added in API level 1
String copyValueOf (char[] data, 
                int offset, 
                int count)

返回一个字符串,它表示指定数组中的字符序列。

Parameters
data char: the character array.
offset int: initial offset of the subarray.
count int: length of the subarray.
Returns
String a String that contains the characters of the specified subarray of the character array.

copyValueOf

Added in API level 1
String copyValueOf (char[] data)

返回一个字符串,它表示指定数组中的字符序列。

Parameters
data char: the character array.
Returns
String a String that contains the characters of the character array.

endsWith

Added in API level 1
boolean endsWith (String suffix)

测试该字符串是否以指定的后缀结尾。

Parameters
suffix String: the suffix.
Returns
boolean true if the character sequence represented by the argument is a suffix of the character sequence represented by this object; false otherwise. Note that the result will be true if the argument is the empty string or is equal to this String object as determined by the equals(Object) method.

equals

Added in API level 1
boolean equals (Object anObject)

将此字符串与指定的对象进行比较。 结果是true当且仅当参数不是null并且是一个String对象,该对象表示与此对象相同的字符序列。

Parameters
anObject Object: The object to compare this String against
Returns
boolean true if the given object represents a String equivalent to this string, false otherwise

也可以看看:

equalsIgnoreCase

Added in API level 1
boolean equalsIgnoreCase (String anotherString)

将此String与另一个String比较,忽略大小写注意事项。 如果两个字符串的长度相同,并且两个字符串中的相应字符相同,忽略大小写,则认为两个字符串忽略大小写相等。

如果至少存在以下一种情况,则两个字符 c1c2被视为相同的忽略情况:

  • The two characters are the same (as compared by the == operator)
  • Applying the method toUpperCase(char) to each character produces the same result
  • Applying the method toLowerCase(char) to each character produces the same result

Parameters
anotherString String: The String to compare this String against
Returns
boolean true if the argument is not null and it represents an equivalent String ignoring case; false otherwise

也可以看看:

format

Added in API level 1
String format (Locale l, 
                String format, 
                Object... args)

使用指定的区域设置,格式字符串和参数返回格式化的字符串。

Parameters
l Locale: The locale to apply during formatting. If l is null then no localization is applied.
format String: A format string
args Object: Arguments referenced by the format specifiers in the format string. If there are more arguments than format specifiers, the extra arguments are ignored. The number of arguments is variable and may be zero. The maximum number of arguments is limited by the maximum dimension of a Java array as defined by The Java™ Virtual Machine Specification. The behaviour on a null argument depends on the conversion.
Returns
String A formatted string
Throws
If a format string contains an illegal syntax, a format specifier that is incompatible with the given arguments, insufficient arguments given the format string, or other illegal conditions. For specification of all possible formatting errors, see the Details section of the formatter class specification
NullPointerException If the format is null

也可以看看:

format

Added in API level 1
String format (String format, 
                Object... args)

使用指定的格式字符串和参数返回格式化的字符串。

始终使用的区域设置是由 Locale.getDefault()返回的区域设置。

Parameters
format String: A format string
args Object: Arguments referenced by the format specifiers in the format string. If there are more arguments than format specifiers, the extra arguments are ignored. The number of arguments is variable and may be zero. The maximum number of arguments is limited by the maximum dimension of a Java array as defined by The Java™ Virtual Machine Specification. The behaviour on a null argument depends on the conversion.
Returns
String A formatted string
Throws
If a format string contains an illegal syntax, a format specifier that is incompatible with the given arguments, insufficient arguments given the format string, or other illegal conditions. For specification of all possible formatting errors, see the Details section of the formatter class specification.
NullPointerException If the format is null

也可以看看:

getBytes

Added in API level 1
byte[] getBytes (String charsetName)

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

此字符串无法在给定字符集中编码时,此方法的行为未指定。 当需要对编码过程进行更多控制时,应该使用CharsetEncoder类。

Parameters
charsetName String: The name of a supported charset
Returns
byte[] The resultant byte array
Throws
UnsupportedEncodingException If the named charset is not supported

getBytes

Added in API level 1
byte[] getBytes ()

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

此字符串不能在默认字符集中编码时,此方法的行为未指定。 当需要对编码过程进行更多控制时,应该使用CharsetEncoder类。

Returns
byte[] The resultant byte array

getBytes

Added in API level 9
byte[] getBytes (Charset charset)

使用给定的 charset将此 String编码为一个字节序列,将结果存储到新的字节数组中。

此方法始终用此字符集的默认替换字节数组替换格式错误的输入和不可映射字符序列。 当需要对编码过程进行更多控制时,应该使用CharsetEncoder类。

Parameters
charset Charset: The Charset to be used to encode the String
Returns
byte[] The resultant byte array

getBytes

Added in API level 1
void getBytes (int srcBegin, 
                int srcEnd, 
                byte[] dst, 
                int dstBegin)

此方法在API级别1中已弃用。
此方法不能正确地将字符转换为字节。 从JDK 1.1开始,首选的方法是通过getBytes()方法,该方法使用平台的默认字符集。

将字符串中的字符复制到目标字节数组中。 每个字节接收相应字符的8个低位。 每个字符的八个高位不会被复制,也不会以任何方式参与传输。

要复制的第一个字符位于索引号srcBegin ; 最后要复制的字符位于索引srcEnd-1 要复制的字符总数为srcEnd-srcBegin 转换为字节的字符被复制到从索引dstBegin开始到索引dstBegin结束的dstdst

     dstbegin + (srcEnd-srcBegin) - 1
 

Parameters
srcBegin int: Index of the first character in the string to copy
srcEnd int: Index after the last character in the string to copy
dst byte: The destination array
dstBegin int: The start offset in the destination array
Throws
IndexOutOfBoundsException If any of the following is true:
  • srcBegin is negative
  • srcBegin is greater than srcEnd
  • srcEnd is greater than the length of this String
  • dstBegin is negative
  • dstBegin+(srcEnd-srcBegin) is larger than dst.length

getChars

Added in API level 1
void getChars (int srcBegin, 
                int srcEnd, 
                char[] dst, 
                int dstBegin)

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

要复制的第一个字符位于索引srcBegin ; 要复制的最后一个字符位于索引srcEnd-1 (因此要复制的字符总数为srcEnd-srcBegin )。 字符被复制到dst的子dst从索引dstBegin开始到索引:

     dstbegin + (srcEnd-srcBegin) - 1
 

Parameters
srcBegin int: index of the first character in the string to copy.
srcEnd int: index after the last character in the string to copy.
dst char: the destination array.
dstBegin int: the start offset in the destination array.
Throws
IndexOutOfBoundsException If any of the following is true:
  • srcBegin is negative.
  • srcBegin is greater than srcEnd
  • srcEnd is greater than the length of this string
  • dstBegin is negative
  • dstBegin+(srcEnd-srcBegin) is larger than dst.length

hashCode

Added in API level 1
int hashCode ()

返回此字符串的哈希码。 String对象的哈希码计算如下

 s[0]*31^(n-1) + s[1]*31^(n-2) + ... + s[n-1]
 
using int arithmetic, where s[i] is the ith character of the string, n is the length of the string, and ^ indicates exponentiation. (The hash value of the empty string is zero.)

Returns
int a hash code value for this object.

indexOf

Added in API level 1
int indexOf (int ch, 
                int fromIndex)

返回指定字符首次出现的此字符串内的索引,从指定索引处开始搜索。

如果与值的字符ch在此表示的字符序列发生String的索引不小于在对象fromIndex ,则返回第一个这样的匹配项的索引。 对于0到0xFFFF(含)范围内的值ch ,这是最小值k ,以便:

 (this.charAt(k) == ch) && (k >= fromIndex)
 
is true. For other values of ch, it is the smallest value k such that:
 (this.codePointAt(k) == ch) && (k >= fromIndex)
 
is true. In either case, if no such character occurs in this string at or after position fromIndex, then -1 is returned.

fromIndex的价值没有限制。 如果它是负数,它的效果就好像它为零一样:可以搜索整个字符串。 如果它大于此字符串的长度,则它具有与该字符串的长度相等的效果:返回-1

所有索引均以 char值(Unicode代码单元)指定。

Parameters
ch int: a character (Unicode code point).
fromIndex int: the index to start the search from.
Returns
int the index of the first occurrence of the character in the character sequence represented by this object that is greater than or equal to fromIndex, or -1 if the character does not occur.

indexOf

Added in API level 1
int indexOf (String str)

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

返回的索引是最小值 k ,其中:

 this.startsWith(str, k)
 
If no such value of k exists, then -1 is returned.

Parameters
str String: the substring to search for.
Returns
int the index of the first occurrence of the specified substring, or -1 if there is no such occurrence.

indexOf

Added in API level 1
int indexOf (int ch)

返回指定字符第一次出现的此字符串中的索引。 如果在这个String对象表示的字符序列中出现一个值为ch的字符,那么返回第一个这样的事件的索引(以Unicode代码为单位)。 对于0到0xFFFF(含)范围内的值ch ,这是最小的值k ,因此:

 this.charAt(k) == ch
 
is true. For other values of ch, it is the smallest value k such that:
 this.codePointAt(k) == ch
 
is true. In either case, if no such character occurs in this string, then -1 is returned.

Parameters
ch int: a character (Unicode code point).
Returns
int the index of the first occurrence of the character in the character sequence represented by this object, or -1 if the character does not occur.

indexOf

Added in API level 1
int indexOf (String str, 
                int fromIndex)

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

返回的索引是最小值 k ,其中:

 k >= fromIndex && this.startsWith(str, k)
 
If no such value of k exists, then -1 is returned.

Parameters
str String: the substring to search for.
fromIndex int: the index from which to start the search.
Returns
int the index of the first occurrence of the specified substring, starting at the specified index, or -1 if there is no such occurrence.

intern

Added in API level 1
String intern ()

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

一组字符串,最初是空的,由类 String私下维护。

当调用实习生方法中,如果池已包含一个字符串等于该String如由所确定的对象equals(Object)方法,然后从池中字符串被返回。 否则,将此String对象添加到池中,并返回对此String对象的引用。

由此可见,对于任何两个字符串 sts.intern() == t.intern()true当且仅当 s.equals(t)true

所有的文字字符串和字符串值的常量表达式都被禁用。 字符串文字在The Java™ Language Specification的第3.10.5节中定义。

Returns
String a string that has the same contents as this string, but is guaranteed to be from a pool of unique strings.

isEmpty

Added in API level 9
boolean isEmpty ()

返回 true,当且仅当, length()0。

Returns
boolean true if length() is 0, otherwise false

lastIndexOf

Added in API level 1
int lastIndexOf (int ch)

返回指定字符最后一次出现的字符串中的索引。 对于0到0xFFFF(含)范围内的值ch ,返回的索引(以Unicode代码单位表示)是最大值k ,因此:

 this.charAt(k) == ch
 
is true. For other values of ch, it is the largest value k such that:
 this.codePointAt(k) == ch
 
is true. In either case, if no such character occurs in this string, then -1 is returned. The String is searched backwards starting at the last character.

Parameters
ch int: a character (Unicode code point).
Returns
int the index of the last occurrence of the character in the character sequence represented by this object, or -1 if the character does not occur.

lastIndexOf

Added in API level 1
int lastIndexOf (String str, 
                int fromIndex)

返回指定子串的最后一次出现的此字符串中的索引,从指定索引开始向后搜索。

返回的索引是最大值 k ,其中:

 k <= fromIndex && this.startsWith(str, k)
 
If no such value of k exists, then -1 is returned.

Parameters
str String: the substring to search for.
fromIndex int: the index to start the search from.
Returns
int the index of the last occurrence of the specified substring, searching backward from the specified index, or -1 if there is no such occurrence.

lastIndexOf

Added in API level 1
int lastIndexOf (String str)

返回指定子字符串最后一次出现的此字符串中的索引。 最后一次出现的空字符串“”被认为发生在索引值this.length()

返回的索引是最大值 k ,其中:

 this.startsWith(str, k)
 
If no such value of k exists, then -1 is returned.

Parameters
str String: the substring to search for.
Returns
int the index of the last occurrence of the specified substring, or -1 if there is no such occurrence.

lastIndexOf

Added in API level 1
int lastIndexOf (int ch, 
                int fromIndex)

返回指定字符最后一次出现的此字符串中的索引,从指定索引开始向后搜索。 对于范围从0到0xFFFF(含)的ch值,返回的索引是最大值k ,因此:

 (this.charAt(k) == ch) && (k <= fromIndex)
 
is true. For other values of ch, it is the largest value k such that:
 (this.codePointAt(k) == ch) && (k <= fromIndex)
 
is true. In either case, if no such character occurs in this string at or before position fromIndex, then -1 is returned.

所有索引均以 char值(Unicode代码单元)指定。

Parameters
ch int: a character (Unicode code point).
fromIndex int: the index to start the search from. There is no restriction on the value of fromIndex. If it is greater than or equal to the length of this string, it has the same effect as if it were equal to one less than the length of this string: this entire string may be searched. If it is negative, it has the same effect as if it were -1: -1 is returned.
Returns
int the index of the last occurrence of the character in the character sequence represented by this object that is less than or equal to fromIndex, or -1 if the character does not occur before that point.

length

Added in API level 1
int length ()

返回此字符串的长度。 长度等于字符串中的数字Unicode code units

Returns
int the length of the sequence of characters represented by this object.

matches

Added in API level 1
boolean matches (String regex)

告诉这个字符串是否与给定的 regular expression匹配。

格式 str .matches( 正则表达式 )的这种方法的调用产生与 表达式完全相同的结果

Pattern.matches( regex , str )

Parameters
regex String: the regular expression to which this string is to be matched
Returns
boolean true if, and only if, this string matches the given regular expression
Throws
PatternSyntaxException if the regular expression's syntax is invalid

也可以看看:

offsetByCodePoints

Added in API level 1
int offsetByCodePoints (int index, 
                int codePointOffset)

返回此String内的索引,该索引与给定的index codePointOffset码点。 indexcodePointOffset给出的文本范围内的未配对代理每个计为一个代码点。

Parameters
index int: the index to be offset
codePointOffset int: the offset in code points
Returns
int the index within this String
Throws
IndexOutOfBoundsException if index is negative or larger then the length of this String, or if codePointOffset is positive and the substring starting with index has fewer than codePointOffset code points, or if codePointOffset is negative and the substring before index has fewer than the absolute value of codePointOffset code points.

regionMatches

Added in API level 1
boolean regionMatches (boolean ignoreCase, 
                int toffset, 
                String other, 
                int ooffset, 
                int len)

测试两个字符串区域是否相等。

将此String对象的子字符串与参数other的子字符串进行比较 如果这些子字符串表示相同的字符序列,则结果为true ,当且仅当ignoreCase为真时,忽略大小写。 该待比较的String对象的子串从索引toffset开始,长度为len 待比较的子串other从索引ooffset开始,长度为len 结果是false当且仅当以下至少一个条件成立:

  • toffset is negative.
  • ooffset is negative.
  • toffset+len is greater than the length of this String object.
  • ooffset+len is greater than the length of the other argument.
  • ignoreCase is false and there is some nonnegative integer k less than len such that:
     this.charAt(toffset+k) != other.charAt(ooffset+k)
     
  • ignoreCase is true and there is some nonnegative integer k less than len such that:
     Character.toLowerCase(this.charAt(toffset+k)) !=
         Character.toLowerCase(other.charAt(ooffset+k))
     
    and:
     Character.toUpperCase(this.charAt(toffset+k)) !=
             Character.toUpperCase(other.charAt(ooffset+k))
     

Parameters
ignoreCase boolean: if true, ignore case when comparing characters.
toffset int: the starting offset of the subregion in this string.
other String: the string argument.
ooffset int: the starting offset of the subregion in the string argument.
len int: the number of characters to compare.
Returns
boolean true if the specified subregion of this string matches the specified subregion of the string argument; false otherwise. Whether the matching is exact or case insensitive depends on the ignoreCase argument.

regionMatches

Added in API level 1
boolean regionMatches (int toffset, 
                String other, 
                int ooffset, 
                int len)

测试两个字符串区域是否相等。

String对象的子字符串与参数other的子字符串进行比较。 如果这些子字符串表示相同的字符序列,则结果为真。 String要比较的对象的子串从索引toffset开始,长度为len 其他待比较的子串从索引ooffset开始,长度为len 结果是false当且仅当以下至少一个条件成立:

  • toffset is negative.
  • ooffset is negative.
  • toffset+len is greater than the length of this String object.
  • ooffset+len is greater than the length of the other argument.
  • There is some nonnegative integer k less than len such that: this.charAt(toffset+k) != other.charAt(ooffset+k)

Parameters
toffset int: the starting offset of the subregion in this string.
other String: the string argument.
ooffset int: the starting offset of the subregion in the string argument.
len int: the number of characters to compare.
Returns
boolean true if the specified subregion of this string exactly matches the specified subregion of the string argument; false otherwise.

replace

Added in API level 1
String replace (CharSequence target, 
                CharSequence replacement)

将此字符串的每个子字符串替换为指定的文字替换序列的文字目标序列。 替换从字符串开始到结束,例如,用字符串“aaa”中的“b”替换“aa”将导致“ba”而不是“ab”。

Parameters
target CharSequence: The sequence of char values to be replaced
replacement CharSequence: The replacement sequence of char values
Returns
String The resulting string
Throws
NullPointerException if target or replacement is null.

replace

Added in API level 1
String replace (char oldChar, 
                char newChar)

返回从更换所有出现而产生的新的字符串 oldChar ,在这个字符串 newChar

如果字符oldChar未出现在由此String对象表示的字符序列中,则返回对此String对象的引用。 否则,将创建一个新的String对象,该对象表示与此String对象所表示的字符序列相同的字符序列,但每次出现的oldChar都被替换为newChar

例子:

 "mesquite in your cellar".replace('e', 'o')
         returns "mosquito in your collar"
 "the war of baronets".replace('r', 'y')
         returns "the way of bayonets"
 "sparring with a purple porpoise".replace('p', 't')
         returns "starring with a turtle tortoise"
 "JonL".replace('q', 'x') returns "JonL" (no change)
 

Parameters
oldChar char: the old character.
newChar char: the new character.
Returns
String a string derived from this string by replacing every occurrence of oldChar with newChar.

replaceAll

Added in API level 1
String replaceAll (String regex, 
                String replacement)

用给定的替换替换与给定的 regular expression相匹配的该字符串的每个子字符串。

格式 str .replaceAll( regex , repl )的这种方法的调用产生与表达式完全相同的结果

Pattern.compile( regex ).matcher( str ).replaceAll( repl )

请注意替换字符串中的反斜杠( \ )和美元符号( $ )可能会导致结果与将它视为字面替换字符串时的结果不同; Matcher.replaceAll 如果需要,使用quoteReplacement(String)来抑制这些字符的特殊含义。

Parameters
regex String: the regular expression to which this string is to be matched
replacement String: the string to be substituted for each match
Returns
String The resulting String
Throws
PatternSyntaxException if the regular expression's syntax is invalid

也可以看看:

replaceFirst

Added in API level 1
String replaceFirst (String regex, 
                String replacement)

用给定的替换替换此字符串的第一个子字符串,该字符串与给定的 regular expression匹配。

格式 str .replaceFirst( regex , repl )的这种方法的调用将产生与表达式完全相同的结果

Pattern.compile( regex ).matcher( str ).replaceFirst( repl )

请注意替换字符串中的反斜杠( \ )和美元符号( $ )可能会导致结果与将它视为字面替换字符串时的结果不同; replaceFirst(String) 如果需要,使用quoteReplacement(String)来抑制这些字符的特殊含义。

Parameters
regex String: the regular expression to which this string is to be matched
replacement String: the string to be substituted for the first match
Returns
String The resulting String
Throws
PatternSyntaxException if the regular expression's syntax is invalid

也可以看看:

split

Added in API level 1
String[] split (String regex, 
                int limit)

将该字符串拆分为给定的 regular expression的匹配。

此方法返回的数组包含此字符串的每个子字符串,该字符串由与给定表达式匹配的另一个子字符串终止,或者由字符串的结尾终止。 数组中的子字符串按照它们在此字符串中出现的顺序排列。 如果表达式不匹配输入的任何部分,则结果数组只有一个元素,即该字符串。

limit参数控制模式应用的次数,因此影响结果数组的长度。 如果极限值n大于零,那么模式将最多应用n -1次,数组的长度不会大于n ,并且数组的最后一项将包含超出最后匹配分隔符的所有输入。 如果n是非正值,那么该模式将尽可能多地应用,并且该数组可以具有任何长度。 如果n为零,则模式将尽可能多次应用,数组可以有任意长度,并且尾随的空字符串将被丢弃。

例如,字符串 "boo:and:foo"通过这些参数产生以下结果:

Regex Limit Result
: 2 { "boo", "and:foo" }
: 5 { "boo", "and", "foo" }
: -2 { "boo", "and", "foo" }
o 5 { "b", "", ":and:f", "", "" }
o -2 { "b", "", ":and:f", "", "" }
o 0 { "b", "", ":and:f" }

调用str的这种方法 split( 正则表达式 , n )产生与表达式相同的结果

Pattern. compile ( regex ). split ( str ,  n )

Parameters
regex String: the delimiting regular expression
limit int: the result threshold, as described above
Returns
String[] the array of strings computed by splitting this string around matches of the given regular expression
Throws
PatternSyntaxException if the regular expression's syntax is invalid

也可以看看:

split

Added in API level 1
String[] split (String regex)

将该字符串拆分为给定的 regular expression

此方法的工作原理与通过调用具有给定表达式和极限参数为零的双参数split方法一样。 尾随的空字符串因此不包含在结果数组中。

例如,字符串 "boo:and:foo"可用以下表达式得出以下结果:

Regex Result
: { "boo", "and", "foo" }
o { "b", "", ":and:f" }

Parameters
regex String: the delimiting regular expression
Returns
String[] the array of strings computed by splitting this string around matches of the given regular expression
Throws
PatternSyntaxException if the regular expression's syntax is invalid

也可以看看:

startsWith

Added in API level 1
boolean startsWith (String prefix)

测试此字符串是否以指定的前缀开头。

Parameters
prefix String: the prefix.
Returns
boolean true if the character sequence represented by the argument is a prefix of the character sequence represented by this string; false otherwise. Note also that true will be returned if the argument is an empty string or is equal to this String object as determined by the equals(Object) method.

startsWith

Added in API level 1
boolean startsWith (String prefix, 
                int toffset)

测试从指定索引处开始的此字符串的子字符串是否以指定的前缀开头。

Parameters
prefix String: the prefix.
toffset int: where to begin looking in this string.
Returns
boolean true if the character sequence represented by the argument is a prefix of the substring of this object starting at index toffset; false otherwise. The result is false if toffset is negative or greater than the length of this String object; otherwise the result is the same as the result of the expression
          this.substring(toffset).startsWith(prefix)
          

subSequence

Added in API level 1
CharSequence subSequence (int beginIndex, 
                int endIndex)

返回一个新的字符序列,该序列是该序列的子序列。

这种形式的方法的调用

 str.subSequence(begin, end)
behaves in exactly the same way as the invocation
 str.substring(begin, end)
This method is defined so that the String class can implement the CharSequence interface.

Parameters
beginIndex int: the begin index, inclusive.
endIndex int: the end index, exclusive.
Returns
CharSequence the specified subsequence.
Throws
IndexOutOfBoundsException if beginIndex or endIndex are negative, if endIndex is greater than length(), or if beginIndex is greater than startIndex

substring

Added in API level 1
String substring (int beginIndex, 
                int endIndex)

返回一个新字符串,该字符串是此字符串的一个子字符串。 子字符串从指定的beginIndex开始,并延伸到索引号为endIndex - 1的字符。 因此子字符串的长度是endIndex-beginIndex

例子:

 "hamburger".substring(4, 8) returns "urge"
 "smiles".substring(1, 5) returns "mile"
 

Parameters
beginIndex int: the beginning index, inclusive.
endIndex int: the ending index, exclusive.
Returns
String the specified substring.
Throws
IndexOutOfBoundsException if the beginIndex is negative, or endIndex is larger than the length of this String object, or beginIndex is larger than endIndex.

substring

Added in API level 1
String substring (int beginIndex)

返回一个新字符串,该字符串是此字符串的一个子字符串。 子字符串以指定索引处的字符开头,并延伸到此字符串的末尾。

例子:

 "unhappy".substring(2) returns "happy"
 "Harbison".substring(3) returns "bison"
 "emptiness".substring(9) returns "" (an empty string)
 

Parameters
beginIndex int: the beginning index, inclusive.
Returns
String the specified substring.
Throws
IndexOutOfBoundsException if beginIndex is negative or larger than the length of this String object.

toCharArray

Added in API level 1
char[] toCharArray ()

将此字符串转换为新的字符数组。

Returns
char[] a newly allocated character array whose length is the length of this string and whose contents are initialized to contain the character sequence represented by this string.

toLowerCase

Added in API level 1
String toLowerCase ()

使用默认语言环境的规则将此String所有字符转换为小写。 这相当于拨打toLowerCase(Locale.getDefault())

注意:此方法对区域设置非常敏感,如果用于旨在独立解释区域设置的字符串,则可能会产生意外的结果。 示例是编程语言标识符,协议密钥和HTML标签。 例如, "TITLE".toLowerCase()在土耳其语言环境返回"t\u0131tle" ,其中“\ u0131”是拉丁小写字母无点我的性格。 要获得区域设置不敏感字符串的正确结果,请使用toLowerCase(Locale.ENGLISH)

Returns
String the String, converted to lowercase.

也可以看看:

toLowerCase

Added in API level 1
String toLowerCase (Locale locale)

使用给定的Locale的规则将此String所有字符转换为Locale 案例映射基于Character类指定的Unicode标准版本。 由于大小写映射并不总是1:1字符映射,因此生成的String可能与原始String长度不同。

小写映射的示例如下表所示:

Language Code of Locale Upper Case Lower Case 描述
tr (Turkish) \u0130 \u0069 capital letter I with dot above -> small letter i
tr (Turkish) \u0049 \u0131 capital letter I -> small letter dotless i
(all) French Fries french fries lowercased all chars in String
(all) capiotacapchi capthetacapupsil capsigma iotachi thetaupsilon sigma lowercased all chars in String

Parameters
locale Locale: use the case transformation rules for this locale
Returns
String the String, converted to lowercase.

也可以看看:

toString

Added in API level 1
String toString ()

这个对象(它已经是一个字符串!)本身返回。

Returns
String the string itself.

toUpperCase

Added in API level 1
String toUpperCase (Locale locale)

使用给定的Locale的规则将此String所有字符转换为大写。 案例映射基于Character类指定的Unicode标准版本。 由于大小写映射并不总是1:1字符映射,因此生成的String可能与原始String长度不同。

区域设置敏感和1:M大小写映射的示例如下表所示。

Language Code of Locale Lower Case Upper Case 描述
tr (Turkish) \u0069 \u0130 small letter i -> capital letter I with dot above
tr (Turkish) \u0131 \u0049 small letter dotless i -> capital letter I
(all) \u00df \u0053 \u0053 small letter sharp s -> two letters: SS
(all) Fahrvergnügen FAHRVERGNÜGEN

Parameters
locale Locale: use the case transformation rules for this locale
Returns
String the String, converted to uppercase.

也可以看看:

toUpperCase

Added in API level 1
String toUpperCase ()

使用默认语言环境的规则将此String所有字符转换为大写。 这种方法相当于toUpperCase(Locale.getDefault())

注意:此方法对区域设置非常敏感,如果用于旨在独立解释区域设置的字符串,则可能会产生意外的结果。 示例是编程语言标识符,协议密钥和HTML标签。 例如, "title".toUpperCase()在土耳其语言环境返回"T\u0130TLE" ,其中“\ u0130”是拉丁文大写字母我带点上述特征。 要获得区域设置不敏感字符串的正确结果,请使用toUpperCase(Locale.ENGLISH)

Returns
String the String, converted to uppercase.

也可以看看:

trim

Added in API level 1
String trim ()

返回字符串的副本,省略前导和尾随空白。

如果此 String对象表示一个空字符序列,或由该代表字符序列的第一个和最后一个字符 String对象都具有代码大于 '\u0020' (空格字符),则此参考 String被返回对象。

否则,如果字符串中不存在代码大于 '\u0020'的字符,则会创建并返回代表空字符串的新对象 String

否则,令k为代码大于'\u0020'的字符串中第一个字符的索引,并且让m为代码大于'\u0020'的字符串中最后一个字符的索引。 将创建一个新的String对象,该对象表示此字符串的子字符串,该字符串以索引k处的字符开头,并以索引m处的字符结尾 - 即this.substring(km+1)的结果。

该方法可用于从字符串的开始和结尾修剪空白(如上定义)。

Returns
String A copy of this string with leading and trailing white space removed, or this string if it has no leading or trailing white space.

valueOf

Added in API level 1
String valueOf (boolean b)

返回参数 boolean的字符串表示形式。

Parameters
b boolean: a boolean.
Returns
String if the argument is true, a string equal to "true" is returned; otherwise, a string equal to "false" is returned.

valueOf

Added in API level 1
String valueOf (double d)

返回 double参数的字符串表示形式。

该表示正是由一个参数的 Double.toString方法返回的表示。

Parameters
d double: a double.
Returns
String a string representation of the double argument.

也可以看看:

valueOf

Added in API level 1
String valueOf (char[] data, 
                int offset, 
                int count)

返回 char数组参数的特定子阵列的字符串表示形式。

offset参数是子offset的第一个字符的索引。 count参数指定子阵列的长度。 子数组的内容被复制; 字符数组的后续修改不会影响新创建的字符串。

Parameters
data char: the character array.
offset int: the initial offset into the value of the String.
count int: the length of the value of the String.
Returns
String a string representing the sequence of characters contained in the subarray of the character array argument.
Throws
IndexOutOfBoundsException if offset is negative, or count is negative, or offset+count is larger than data.length.

valueOf

Added in API level 1
String valueOf (float f)

返回 float参数的字符串表示形式。

该表示法正好是由一个参数的 Float.toString方法返回的 Float.toString法。

Parameters
f float: a float.
Returns
String a string representation of the float argument.

也可以看看:

valueOf

Added in API level 1
String valueOf (int i)

返回 int参数的字符串表示形式。

该表示法正好是由一个参数的 Integer.toString方法返回的 Integer.toString法。

Parameters
i int: an int.
Returns
String a string representation of the int argument.

也可以看看:

valueOf

Added in API level 1
String valueOf (char c)

返回 char参数的字符串表示形式。

Parameters
c char: a char.
Returns
String a string of length 1 containing as its single character the argument c.

valueOf

Added in API level 1
String valueOf (long l)

返回 long参数的字符串表示形式。

该表示正是由一个参数的 Long.toString方法返回的表示。

Parameters
l long: a long.
Returns
String a string representation of the long argument.

也可以看看:

valueOf

Added in API level 1
String valueOf (Object obj)

返回 Object参数的字符串表示形式。

Parameters
obj Object: an Object.
Returns
String if the argument is null, then a string equal to "null"; otherwise, the value of obj.toString() is returned.

也可以看看:

valueOf

Added in API level 1
String valueOf (char[] data)

返回char数组参数的字符串表示形式。 字符数组的内容被复制; 字符数组的后续修改不会影响新创建的字符串。

Parameters
data char: a char array.
Returns
String a newly allocated string representing the same sequence of characters contained in the character array argument.

Hooray!