String 类

定义

命名空间:

Java.Lang

程序集:

Mono.Android.dll

类 String 表示字符串。

[Android.Runtime.Register("java/lang/String", DoNotGenerateAcw=true)]
public sealed class String : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.IO.ISerializable, Java.Lang.ICharSequence, Java.Lang.IComparable, System.Collections.Generic.IEnumerable<char>

[<Android.Runtime.Register("java/lang/String", DoNotGenerateAcw=true)>]
type String = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ICharSequence
    interface seq<char>
    interface IEnumerable
    interface IComparable

继承

Object

Object

String

属性

RegisterAttribute

实现

IJavaObject IJavaPeerable ISerializable ICharSequence IComparable IEnumerable<Char> IEnumerable IDisposable

注解

类 String 表示字符串。 Java 程序（如 "abc"）中的所有字符串文本都作为此类的实例实现。

字符串是常量;其值在创建后无法更改。 字符串缓冲区支持可变字符串。 由于 String 对象是不可变的，因此可以共享它们。 例如： <blockquote>

String str = "abc";

</blockquote>

等效于： <blockquote>

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

</blockquote>

下面是一些有关如何使用字符串的更多示例： <blockquote>

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

</blockquote>

类 String 包括用于检查序列的各个字符、比较字符串、搜索字符串、提取子字符串以及创建所有字符转换为大写或小写的字符串副本的方法。 事例映射基于 类指定的 java.lang.Character Character Unicode 标准版本。

Java 语言为字符串串联运算符 ( + ) 以及将其他对象转换为字符串提供特殊支持。 有关字符串串联和转换的其他信息，请参阅 Java&交易;语言规范。

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

表示 String UTF-16 格式的字符串，其中 <em>增补字符</em> 由 <em>代理项对</em> 表示 (请参阅 类中的 Character Unicode 字符表示形式部分以获取) 的详细信息。 索引值引用 char 代码单位，因此补充字符使用 中的两个 String位置。

类 String 提供用于处理 Unicode 码位的方法 (，即字符) ，以及用于处理 Unicode 码位 (char 即值) 的方法。

除非另有说明，否则用于比较字符串的方法不考虑区域设置。 类 java.text.Collator 提供用于精细、区分区域设置的字符串比较的方法。

在 1.0 中添加。

的 java.lang.StringJava 文档。

此页面的某些部分是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的条款使用。

构造函数

String()	创建一个空字符串。
String(Byte[])	通过使用平台的默认字符集解码指定的字节数组来构造新的 String 。
String(Byte[], Charset)	通过使用指定的 java 解码指定的字节数组来构造一个新的 String 。
String(Byte[], Int32)	已过时. 分配由 8 位整数值数组构造的新 String 包含字符。
String(Byte[], Int32, Int32)	通过使用平台的默认字符集解码字节的指定子数组来构造新的 String 。
String(Byte[], Int32, Int32, Charset)	通过使用指定的 java 解码字节的指定子数组来构造新的 String 。
String(Byte[], Int32, Int32, Int32)	已过时. 分配从 8 位整数值数组的子数组构造的新 String 。
String(Byte[], Int32, Int32, String)	通过使用指定的字符集解码字节的指定子数组来构造新的 String 。
String(Byte[], String)	通过使用指定的 java 解码指定的字节数组来构造一个新的 String 。
String(Char[])	初始化此字符串以包含给定 char的 。
String(Char[], Int32, Int32)	初始化此字符串以包含给定 char的 。
String(Int32[], Int32, Int32)	分配一个新的 String ，其中包含 Unicode 代码点数组参数的子数组中的字符。
String(String)	使用与 相同的字符 toCopy序列构造新字符串。
String(StringBuffer)	分配一个新字符串，其中包含字符串缓冲区参数中当前包含的字符序列。
String(StringBuilder)	分配一个新字符串，其中包含字符串生成器参数中当前包含的字符序列。

属性

CaseInsensitiveOrder	一个比较器，它按 compareToIgnoreCase将对象排序String为 。
Class	返回此 Object的运行时类。 (继承自 Object)
Handle	基础 Android 实例的句柄。 (继承自 Object)
IsBlank	true如果字符串为空或仅Character#isWhitespace(int) white space包含代码点，则返回 ;否则返回 false。
IsEmpty	true仅当 为 0时，#length()返回 。
JniIdentityHashCode	类 String 表示字符串。 (继承自 Object)
JniPeerMembers	类 String 表示字符串。
PeerReference	类 String 表示字符串。 (继承自 Object)
ThresholdClass	此 API 支持 Mono for Android 基础结构，不应直接从代码使用。 (继承自 Object)
ThresholdType	此 API 支持 Mono for Android 基础结构，不应直接从代码使用。 (继承自 Object)

方法

CharAt(Int32)	返回 char 指定索引处的值。
Clone()	创建并返回此对象的副本。 (继承自 Object)
CodePointAt(Int32)	返回指定索引处) Unicode 码位 (字符。
CodePointBefore(Int32)	返回指定索引前 (Unicode 码位) 字符。
CodePointCount(Int32, Int32)	返回此 String的指定文本范围内 Unicode 码位的数目。
CompareTo(String)	按字典比较两个字符串。
CompareToIgnoreCase(String)	按字典比较两个字符串，忽略大小写差异。
Concat(String)	将指定的字符串连接到此字符串的末尾。
Contains(ICharSequence)	仅当此字符串包含指定的字符值序列时，返回 true。
Contains(String)	仅当此字符串包含指定的字符值序列时，返回 true。
ContentEquals(ICharSequence)	将此字符串与指定的 CharSequence进行比较。
ContentEquals(String)	将此字符串与指定的 CharSequence进行比较。
ContentEquals(StringBuffer)	将此字符串与指定的 StringBuffer进行比较。
CopyValueOf(Char[])	等效于 #valueOf(char[])。
CopyValueOf(Char[], Int32, Int32)	等效于 #valueOf(char[], int, int)。
Dispose()	类 String 表示字符串。 (继承自 Object)
Dispose(Boolean)	类 String 表示字符串。 (继承自 Object)
EndsWith(String)	测试此字符串是否以指定的后缀结尾。
Equals(Object)	指示其他某个对象是否“等于”此对象。 (继承自 Object)
EqualsIgnoreCase(String)	将此 String 与另一个 String进行比较，忽略事例注意事项。
Format(Locale, String, Object[])	使用指定的格式字符串和参数返回格式化字符串。
Format(String, Object[])	使用指定的格式字符串和参数返回格式化字符串。
Formatted(Object[])	类 String 表示字符串。
GetBytes()	使用平台的默认字符集将其 String 编码为字节序列，并将结果存储到新的字节数组中。
GetBytes(Charset)	使用给定 java 将其 String 编码为字节序列。
GetBytes(Int32, Int32, Byte[], Int32)	已过时. 将此字符串中的字符复制到目标字节数组中。
GetBytes(String)	使用命名字符集将其 String 编码为字节序列，并将结果存储到新的字节数组中。
GetChars(Int32, Int32, Char[], Int32)	将此字符串中的字符复制到目标字符数组中。
GetEnumerator()	类 String 表示字符串。
GetHashCode()	返回对象的哈希代码值。 (继承自 Object)
Indent(Int32)	根据 的值调整此字符串每行的 n缩进，并规范化行终止字符。
IndexOf(Int32)	返回指定字符的第一个匹配项的此字符串中的索引。
IndexOf(Int32, Int32)	返回指定字符的第一个匹配项的此字符串中的索引，从指定索引处开始搜索。
IndexOf(String)	返回指定子字符串的第一个匹配项的此字符串中的索引。
IndexOf(String, Int32)	从指定索引开始，返回指定子字符串第一次出现的此字符串中的索引。
Intern()	返回字符串对象的规范表示形式。
JavaFinalize()	当垃圾回收确定不再引用对象时，由对象上的垃圾回收器调用。 (继承自 Object)
Join(ICharSequence, ICharSequence[])	返回由联接的副本 CharSequence elements 以及指定 delimiter的副本组成的新字符串。
Join(ICharSequence, IIterable)	返回由联接的副本CharSequence elements与指定 delimiter的副本组成的新 String 。
Join(String, IIterable)	返回由联接的副本CharSequence elements与指定 delimiter的副本组成的新 String 。
Join(String, String[])	返回由联接的副本 CharSequence elements 以及指定 delimiter的副本组成的新字符串。
LastIndexOf(Int32)	返回指定字符的最后一个匹配项的此字符串中的索引。
LastIndexOf(Int32, Int32)	返回指定字符最后一次出现的此字符串中的索引，从指定索引开始向后搜索。
LastIndexOf(String)	返回指定子字符串最后一次出现的此字符串中的索引。
LastIndexOf(String, Int32)	返回指定子字符串最后一次出现的此字符串中的索引，从指定索引处向后搜索。
Length()	返回此字符串的长度。
Matches(String)	指示此字符串是否与给定的正则表达式匹配。
Notify()	唤醒正在等待此对象的监视器的单个线程。 (继承自 Object)
NotifyAll()	唤醒正在等待此对象的监视器的所有线程。 (继承自 Object)
OffsetByCodePoints(Int32, Int32)	返回此 String 中的索引，该索引与由码位给定 index 的 codePointOffset 偏移量。
RegionMatches(Boolean, Int32, String, Int32, Int32)	测试两个字符串区域是否相等。
RegionMatches(Int32, String, Int32, Int32)	测试两个字符串区域是否相等。
Repeat(Int32)	返回一个字符串，其值为此字符串的串联重复 count 次数。
Replace(Char, Char)	返回一个字符串，将此字符串newChar中的所有匹配项oldChar替换为 。
Replace(ICharSequence, ICharSequence)	将此字符串中与文本目标序列匹配的每个子字符串替换为指定的文本替换序列。
Replace(String, String)	将此字符串中与文本目标序列匹配的每个子字符串替换为指定的文本替换序列。
ReplaceAll(String, String)	将此字符串中与给定正则表达式匹配的每个子字符串替换为给定的替换项。
ReplaceFirst(String, String)	将匹配给定正则表达式的此字符串的第一个子字符串替换为给定的替换。
SetHandle(IntPtr, JniHandleOwnership)	设置 Handle 属性。 (继承自 Object)
Split(String)	将此字符串拆分为给定正则表达式的匹配项。
Split(String, Int32)	将此字符串拆分为给定正则表达式的匹配项。
StartsWith(String)	测试此字符串是否以指定的前缀开头。
StartsWith(String, Int32)	测试此字符串的子字符串是否以指定前缀开头。
Strip()	返回一个字符串，其值为此字符串，并删除了所有前导和尾随 Character#isWhitespace(int) white space 。
StripIndent()	返回一个字符串，其值为此字符串，附带的 Character#isWhitespace (int) 从每行的开头和结尾删除空格。
StripLeading()	返回一个字符串，其值为此字符串，并删除了所有前导 Character#isWhitespace(int) white space 。
StripTrailing()	返回一个字符串，其值为此字符串，并删除了所有尾随 Character#isWhitespace(int) white space 。
SubSequence(Int32, Int32)	返回一个字符序列，该序列是此序列的子序列。
SubSequenceFormatted(Int32, Int32)	返回一个字符序列，该序列是此序列的子序列。
Substring(Int32)	返回一个字符串，该字符串是此字符串的子字符串。
Substring(Int32, Int32)	返回一个字符串，该字符串是此字符串的子字符串。
ToArray<T>()	类 String 表示字符串。 (继承自 Object)
ToCharArray()	将此字符串转换为新的字符数组。
ToLowerCase()	使用默认区域设置的规则将此中的所有 String 字符转换为小写。
ToLowerCase(Locale)	使用给定 Locale的规则将此中的所有String字符转换为小写。
ToString()	类 String 表示字符串。
ToUpperCase()	使用默认区域设置的规则将此中的所有 String 字符转换为大写。
ToUpperCase(Locale)	使用给定 Locale的规则将此 中的所有String字符转换为大写。
Transform(IFunction)	此方法允许将函数应用于 this 字符串。
TranslateEscapes()	返回一个字符串，其值为此字符串，其转义序列的转换方式就像在字符串文本中一样。
Trim()	返回一个字符串，其值为此字符串，删除所有前导和尾随空格，其中空格定义为代码点小于或等于 'U+0020' (空格字符) 的任何字符。
UnregisterFromRuntime()	类 String 表示字符串。 (继承自 Object)
ValueOf(Boolean)	返回参数的 boolean 字符串表示形式。
ValueOf(Char)	返回参数的 char 字符串表示形式。
ValueOf(Char[])	返回数组参数的 char 字符串表示形式。
ValueOf(Char[], Int32, Int32)	返回数组参数的特定子数组的 char 字符串表示形式。
ValueOf(Double)	返回参数的 double 字符串表示形式。
ValueOf(Int32)	返回参数的 int 字符串表示形式。
ValueOf(Int64)	返回参数的 long 字符串表示形式。
ValueOf(Object)	返回参数的 Object 字符串表示形式。
ValueOf(Single)	返回参数的 float 字符串表示形式。
Wait()	导致当前线程等待，直到它被唤醒，通常是通过 em <通知/em> 或 <em>interrupted</em>。<> (继承自 Object)
Wait(Int64)	导致当前线程等待，直到它被唤醒，通常是通过 em <通知/em> 或 <em>interrupted</em>，或直到经过一定数量的实时。<> (继承自 Object)
Wait(Int64, Int32)	导致当前线程等待，直到它被唤醒，通常是通过 em <通知/em> 或 <em>interrupted</em>，或直到经过一定数量的实时。<> (继承自 Object)

显式接口实现

IComparable.CompareTo(Object)	类 String 表示字符串。
IEnumerable.GetEnumerator()	类 String 表示字符串。
IJavaPeerable.Disposed()	类 String 表示字符串。 (继承自 Object)
IJavaPeerable.DisposeUnlessReferenced()	类 String 表示字符串。 (继承自 Object)
IJavaPeerable.Finalized()	类 String 表示字符串。 (继承自 Object)
IJavaPeerable.JniManagedPeerState	类 String 表示字符串。 (继承自 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	类 String 表示字符串。 (继承自 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	类 String 表示字符串。 (继承自 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	类 String 表示字符串。 (继承自 Object)

扩展方法

JavaCast<TResult>(IJavaObject)	执行 Android 运行时检查的类型转换。
JavaCast<TResult>(IJavaObject)	类 String 表示字符串。
GetJniTypeName(IJavaPeerable)	类 String 表示字符串。
SubSequence(ICharSequence, Int32, Int32)	类 String 表示字符串。