String 构造函数

定义

重载

名称 说明
String()

创建空字符串。

String(Byte[], Int32, Int32, String)

通过使用指定的字符集解码指定的字节数组来构造新的 String 字节。

String(Byte[], Int32, Int32, Int32)
已过时.

分配从 8 位整数值的数组的子数组构造的新 String 构造。

String(Int32[], Int32, Int32)

分配一个新 String 值,其中包含 Unicode 码位数组参数的子数组中的字符。

String(Char[], Int32, Int32)

初始化此字符串以包含给定 char的字符串。

String(Byte[], Int32, Int32)

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

String(Byte[], String)

通过使用指定的 java 解码指定的字节数组来构造新的 String 字节数组。

String(Byte[], Int32, Int32, Charset)

通过使用指定的 java 解码指定的字节的子数组来构造新的 String 字节。

String(Byte[], Charset)

通过使用指定的 java 解码指定的字节数组来构造新的 String 字节数组。

String(String)

构造与 . 相同的字符 toCopy序列的新字符串。

String(Char[])

初始化此字符串以包含给定 char的字符串。

String(Byte[])

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

String(Byte[], Int32)
已过时.

分配从 8 位整数值的数组构造的新 String 包含字符。

String(StringBuilder)

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

String(StringBuffer)

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

String()

创建空字符串。

[Android.Runtime.Register(".ctor", "()V", "")]
public String();
属性

注解

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

String(Byte[], Int32, Int32, String)

通过使用指定的字符集解码指定的字节数组来构造新的 String 字节。

[Android.Runtime.Register(".ctor", "([BIILjava/lang/String;)V", "")]
public String(byte[]? bytes, int offset, int length, string charsetName);
[<Android.Runtime.Register(".ctor", "([BIILjava/lang/String;)V", "")>]
new Java.Lang.String : byte[] * int * int * string -> Java.Lang.String

参数

bytes
Byte[]

要解码为字符的字节数

offset
Int32

要解码的第一个字节的索引

length
Int32

要解码的字节数

charsetName
String

支持的 java.nio.charset.Charset 字符集的名称

属性

例外

如果 data == null

如果 byteCount data.length

如果不支持命名字符集,则为 。

注解

适用于 . 的 java.lang.String.String(byte[], int, int, java.lang.String)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

String(Byte[], Int32, Int32, Int32)

注意

deprecated

分配从 8 位整数值的数组的子数组构造的新 String 构造。

[Android.Runtime.Register(".ctor", "([BIII)V", "")]
[System.Obsolete("deprecated")]
public String(byte[]? ascii, int hibyte, int offset, int count);
[<Android.Runtime.Register(".ctor", "([BIII)V", "")>]
[<System.Obsolete("deprecated")>]
new Java.Lang.String : byte[] * int * int * int -> Java.Lang.String

参数

ascii
Byte[]

要转换为字符的字节数

hibyte
Int32

每个 16 位 Unicode 代码单元的前 8 位

offset
Int32

初始偏移量

count
Int32

长度

属性

例外

如果 data == null

如果 byteCount data.length

注解

分配从 8 位整数值的数组的子数组构造的新 String 构造。

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

byte子数组中的每个项都转换为char构造函数中指定的#String(byte[],int) String(byte[],int)值。

此成员已弃用。 此方法无法正确将字节转换为字符。 从 JDK  起;1.1,执行此操作的首选方法是通过 String 采用字符 java.nio.charset.Charset集名称的构造函数或使用平台的默认字符集。

适用于 . 的 java.lang.String.String(byte[], int, int, int)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

String(Int32[], Int32, Int32)

分配一个新 String 值,其中包含 Unicode 码位数组参数的子数组中的字符。

[Android.Runtime.Register(".ctor", "([III)V", "")]
public String(int[]? codePoints, int offset, int count);
[<Android.Runtime.Register(".ctor", "([III)V", "")>]
new Java.Lang.String : int[] * int * int -> Java.Lang.String

参数

codePoints
Int32[]

是 Unicode 码位源的数组

offset
Int32

初始偏移量

count
Int32

长度

属性

例外

如果 codePoints == null

如果任一元素 codePoints 无效,则为 Unicode 码位。

如果或不在 . 的边界内,则为 <a0/a0>。

注解

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

在 1.5 中添加。

适用于 . 的 java.lang.String.String(int[], int, int)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

String(Char[], Int32, Int32)

初始化此字符串以包含给定 char的字符串。

[Android.Runtime.Register(".ctor", "([CII)V", "")]
public String(char[] data, int offset, int charCount);
[<Android.Runtime.Register(".ctor", "([CII)V", "")>]
new Java.Lang.String : char[] * int * int -> Java.Lang.String

参数

data
Char[]
offset
Int32
charCount
Int32
属性

例外

如果 data == null

如果 charCount data.length

注解

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

String(Byte[], Int32, Int32)

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

[Android.Runtime.Register(".ctor", "([BII)V", "")]
public String(byte[]? bytes, int offset, int length);
[<Android.Runtime.Register(".ctor", "([BII)V", "")>]
new Java.Lang.String : byte[] * int * int -> Java.Lang.String

参数

bytes
Byte[]

要解码为字符的字节数

offset
Int32

要解码的第一个字节的索引

length
Int32

要解码的字节数

属性

例外

如果 data == null

如果 byteCount data.length

注解

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

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

在 1.1 中添加。

适用于 . 的 java.lang.String.String(byte[], int, int)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

String(Byte[], String)

通过使用指定的 java 解码指定的字节数组来构造新的 String 字节数组。

[Android.Runtime.Register(".ctor", "([BLjava/lang/String;)V", "")]
public String(byte[]? bytes, string charsetName);
[<Android.Runtime.Register(".ctor", "([BLjava/lang/String;)V", "")>]
new Java.Lang.String : byte[] * string -> Java.Lang.String

参数

bytes
Byte[]

要解码为字符的字节数

charsetName
String

支持的 java.nio.charset.Charset 字符集的名称

属性

例外

如果 data == null

如果不支持,则为 <a0/>。

注解

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

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

在 1.1 中添加。

适用于 . 的 java.lang.String.String(byte[], java.lang.String)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

String(Byte[], Int32, Int32, Charset)

通过使用指定的 java 解码指定的字节的子数组来构造新的 String 字节。

[Android.Runtime.Register(".ctor", "([BIILjava/nio/charset/Charset;)V", "")]
public String(byte[]? bytes, int offset, int length, Java.Nio.Charset.Charset charset);
[<Android.Runtime.Register(".ctor", "([BIILjava/nio/charset/Charset;)V", "")>]
new Java.Lang.String : byte[] * int * int * Java.Nio.Charset.Charset -> Java.Lang.String

参数

bytes
Byte[]

要解码为字符的字节数

offset
Int32

要解码的第一个字节的索引

length
Int32

要解码的字节数

charset
Charset

要用于解码的 java.nio.charset.Charset charset bytes

属性

例外

如果 byteCount data.length

如果 data == null

注解

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

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

已在 1.6 中添加。

适用于 . 的 java.lang.String.String(byte[], int, int, java.nio.charset.Charset)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

String(Byte[], Charset)

通过使用指定的 java 解码指定的字节数组来构造新的 String 字节数组。

[Android.Runtime.Register(".ctor", "([BLjava/nio/charset/Charset;)V", "")]
public String(byte[]? bytes, Java.Nio.Charset.Charset charset);
[<Android.Runtime.Register(".ctor", "([BLjava/nio/charset/Charset;)V", "")>]
new Java.Lang.String : byte[] * Java.Nio.Charset.Charset -> Java.Lang.String

参数

bytes
Byte[]

要解码为字符的字节数

charset
Charset

要用于解码的 java.nio.charset.Charset charset bytes

属性

例外

如果 data == null

注解

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

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

已在 1.6 中添加。

适用于 . 的 java.lang.String.String(byte[], java.nio.charset.Charset)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

String(String)

构造与 . 相同的字符 toCopy序列的新字符串。

[Android.Runtime.Register(".ctor", "(Ljava/lang/String;)V", "")]
public String(string toCopy);
[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;)V", "")>]
new Java.Lang.String : string -> Java.Lang.String

参数

toCopy
String
属性

注解

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

String(Char[])

初始化此字符串以包含给定 char的字符串。

[Android.Runtime.Register(".ctor", "([C)V", "")]
public String(char[] data);
[<Android.Runtime.Register(".ctor", "([C)V", "")>]
new Java.Lang.String : char[] -> Java.Lang.String

参数

data
Char[]
属性

例外

如果 data == null

注解

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

String(Byte[])

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

[Android.Runtime.Register(".ctor", "([B)V", "")]
public String(byte[]? bytes);
[<Android.Runtime.Register(".ctor", "([B)V", "")>]
new Java.Lang.String : byte[] -> Java.Lang.String

参数

bytes
Byte[]

要解码为字符的字节数

属性

注解

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

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

在 1.1 中添加。

适用于 . 的 java.lang.String.String(byte[])Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

String(Byte[], Int32)

注意

deprecated

分配从 8 位整数值的数组构造的新 String 包含字符。

[Android.Runtime.Register(".ctor", "([BI)V", "")]
[System.Obsolete("deprecated")]
public String(byte[]? ascii, int hibyte);
[<Android.Runtime.Register(".ctor", "([BI)V", "")>]
[<System.Obsolete("deprecated")>]
new Java.Lang.String : byte[] * int -> Java.Lang.String

参数

ascii
Byte[]

要转换为字符的字节数

hibyte
Int32

每个 16 位 Unicode 代码单元的前 8 位

属性

例外

如果 data == null

注解

分配从 8 位整数值的数组构造的新 String 包含字符。 生成的字符串中的每个字符 c 都是从字节数组中的相应组件 b 构造的,以便:

<blockquote>

<b><i>c</i></b> == (char)(((hibyte &amp; 0xff) &lt;&lt; 8)
                                    | (<b><i>b</i></b> &amp; 0xff))

</blockquote>

此成员已弃用。 此方法无法正确将字节转换为字符。 从 JDK  起;1.1,执行此操作的首选方法是通过 String 采用字符 java.nio.charset.Charset集名称的构造函数或使用平台的默认字符集。

适用于 . 的 java.lang.String.String(byte[], int)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

String(StringBuilder)

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

[Android.Runtime.Register(".ctor", "(Ljava/lang/StringBuilder;)V", "")]
public String(Java.Lang.StringBuilder builder);
[<Android.Runtime.Register(".ctor", "(Ljava/lang/StringBuilder;)V", "")>]
new Java.Lang.String : Java.Lang.StringBuilder -> Java.Lang.String

参数

builder
StringBuilder

执行 StringBuilder 操作

属性

例外

如果 stringBuilder == null

注解

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

提供此构造函数以简化迁移到 StringBuilder此构造函数。 通过 toString 该方法从字符串生成器获取字符串可能会更快运行,并且通常是首选的。

在 1.5 中添加。

适用于 . 的 java.lang.String.String(java.lang.StringBuilder)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

String(StringBuffer)

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

[Android.Runtime.Register(".ctor", "(Ljava/lang/StringBuffer;)V", "")]
public String(Java.Lang.StringBuffer buffer);
[<Android.Runtime.Register(".ctor", "(Ljava/lang/StringBuffer;)V", "")>]
new Java.Lang.String : Java.Lang.StringBuffer -> Java.Lang.String

参数

buffer
StringBuffer

执行 StringBuffer 操作

属性

注解

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

适用于 . 的 java.lang.String.String(java.lang.StringBuffer)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于