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(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 码位。
如果或不在 . 的
注解
分配一个新 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。
如果不支持,则为 <
注解
通过使用指定的 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 & 0xff) << 8)
| (<b><i>b</i></b> & 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 属性许可证中所述的术语使用。