String 构造函数
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| String() |
创建空字符串。 |
| String(Byte[], Int32, Int32, String) |
通过使用指定的字符集解码指定的字节子数组来构造新的 |
| String(Byte[], Int32, Int32, Int32) |
已过时.
分配从 8 位整数值数组的子数组构造的新 |
| String(Int32[], Int32, Int32) |
分配一个新的 |
| String(Char[], Int32, Int32) |
初始化此字符串以包含给定 |
| String(Byte[], Int32, Int32) |
通过使用平台的默认字符集解码指定的字节子数组来构造新的 |
| String(Byte[], String) |
通过使用指定的 java 解码指定的字节数组来构造新的 |
| String(Byte[], Int32, Int32, Charset) |
通过使用指定的 java 解码指定的字节子数组来构造新的 |
| String(Byte[], Charset) |
通过使用指定的 java 解码指定的字节数组来构造新的 |
| String(String) |
使用与 相同的字符 |
| String(Char[]) |
初始化此字符串以包含给定 |
| String(Byte[]) |
通过使用平台的默认字符集解码指定的字节数组来构造新的 |
| String(Byte[], Int32) |
已过时.
分配由 8 位整数值数组构造的新 |
| String(StringBuilder) |
分配一个新字符串，该字符串包含字符串生成器参数中当前包含的字符序列。 |
| String(StringBuffer) |
分配一个新字符串，该字符串包含字符串缓冲区参数中当前包含的字符序列。 |
String()
创建空字符串。
[Android.Runtime.Register(".ctor", "()V", "")]
public String ();- 属性
注解
此页面的某些部分是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的条款使用。
适用于
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 charset 的名称
- 属性
例外
如果 ，则为 data == null。
如果 ，则为 byteCount data.length。
如果不支持命名字符集，则为 。
注解
的 java.lang.String.String(byte[], int, int, java.lang.String)Java 文档。
此页面的某些部分是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的条款使用。
适用于
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。
if 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 文档。
此页面的某些部分是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的条款使用。
适用于
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 码位，则为 。
如果 offset 或 count 不在 的 codePoints边界内，则为 。
注解
分配一个新的 String ，其中包含 Unicode 码位数组参数的子数组中的字符。 参数 offset 是子数组的第一个码位的索引， count 参数指定子数组的长度。 子数组的内容将 char转换为 ;数组的 int 后续修改不会影响新创建的字符串。
在 1.5 中添加。
的 java.lang.String.String(int[], int, int)Java 文档。
此页面的某些部分是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的条款使用。
适用于
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。
if charCount data.length
注解
此页面的某些部分是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的条款使用。
适用于
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 。 new String 的长度是字符集的函数，因此可能不等于子数组的长度。
未指定默认字符集中给定字节无效时此构造函数的行为。 java.nio.charset.CharsetDecoder当需要对解码过程进行更多控制时，应使用 类。
在 1.1 中添加。
的 java.lang.String.String(byte[], int, int)Java 文档。
此页面的某些部分是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的条款使用。
适用于
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 charset 的名称
- 属性
例外
如果 ，则为 data == null。
如果 charsetName 不支持，则为 。
注解
通过使用指定的 java.nio.charset.Charset 字符集对指定的字节数组进行解码来构造新的 String 。 new String 的长度是字符集的函数，因此可能不等于字节数组的长度。
当给定的字节在给定字符集中无效时，此构造函数的行为未指定。 java.nio.charset.CharsetDecoder当需要对解码过程进行更多控制时，应使用 类。
在 1.1 中添加。
的 java.lang.String.String(byte[], java.lang.String)Java 文档。
此页面的部分内容是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的术语使用。
适用于
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
- 属性
例外
if byteCount data.length
if data == null
注解
通过使用指定的 java.nio.charset.Charset 字符集解码字节的指定子数组来构造新的 String 。 new String 的长度是字符集的函数，因此可能不等于子数组的长度。
此方法始终将此字符集的默认替换字符串替换格式错误的输入序列和不可应用字符序列。 java.nio.charset.CharsetDecoder当需要对解码过程进行更多控制时，应使用 类。
在 1.6 中添加。
的 java.lang.String.String(byte[], int, int, java.nio.charset.Charset)Java 文档。
此页面的部分内容是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的术语使用。
适用于
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
- 属性
例外
if data == null
注解
通过使用指定的 java.nio.charset.Charset 字符集解码指定的字节数组来构造新的 String 。 新 String 的长度是字符集的函数，因此可能不等于字节数组的长度。
此方法始终将此字符集的默认替换字符串替换格式错误的输入序列和不可应用字符序列。 java.nio.charset.CharsetDecoder当需要对解码过程进行更多控制时，应使用 类。
在 1.6 中添加。
的 java.lang.String.String(byte[], java.nio.charset.Charset)Java 文档。
此页面的部分内容是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的术语使用。
适用于
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
- 属性
注解
此页面的部分内容是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的术语使用。
适用于
String(Char[])
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 文档。
此页面的部分内容是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的术语使用。
适用于
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 & 0xff) << 8)
| (<b><i>b</i></b> & 0xff))
</blockquote>
此成员已弃用。 此方法无法正确将字节转换为字符。 截至 JDK 1.1，执行此操作的首选方法是通过 String 采用 java.nio.charset.Charset、 charset 名称或使用平台的默认字符集的构造函数。
的 java.lang.String.String(byte[], int)Java 文档。
此页面的部分内容是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的术语使用。
适用于
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 文档。
此页面的部分内容是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的术语使用。
适用于
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 文档。
此页面的部分内容是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的术语使用。