String 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| String() |
會產生一個空字串。 |
| String(Byte[], Int32, Int32, String) |
透過解碼指定的字元組子陣列來構造新字 |
| String(Byte[], Int32, Int32, Int32) |
已淘汰.
由一個 8 位元整數陣列的子陣列配置一個新 |
| String(Int32[], Int32, Int32) |
分配一個包含 Unicode 代碼點陣列參數子陣列字元的新資料 |
| 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 文件 java.lang.String.String(byte[], int, int, java.lang.String)。
此頁面的部分是根據 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 S 依建構子指定char轉換為 a#String(byte[],int) String(byte[],int)。
此會員已被棄用。 此方法無法正確將位元組轉換為字元。 截至JDK 1.1 中,首選方式是使用 String 取 java.nio.charset.Charset、字元集名稱的建構子,或使用平台預設字元集。
Java 文件 java.lang.String.String(.*byte[], .*int, .*int, .*int)。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
String(Int32[], Int32, Int32)
分配一個包含 Unicode 代碼點陣列參數子陣列字元的新資料 String 。
[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 代碼點。
若 offsetcount 或不在 的 codePoints範圍內。
備註
分配一個包含 Unicode 代碼點陣列參數子陣列字元的新資料 String 。 參數 offset 是子陣列第一個碼點的索引,而 count 參數則指定子陣列的長度。 子陣列的內容會被轉換成 chars;後續修改 int 陣列不會影響新建立的字串。
已在1.5中新增。
Java 文件 java.lang.String.String(.*int[], .*int, .*int)。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
String(Char[], Int32, Int32)
初始化此字串以包含給定 char的 s。
[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 文件 java.lang.String.String(.*byte[], .*int, .*int)。
此頁面的部分是根據 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。
如果 charsetName 不支援。
備註
透過使用指定的 java.nio.charset.Charset 字元集解碼指定的位元組陣列來構造一個新字 String 元。 新 String 的長度是字元集的函數,因此可能不等於位元組陣列的長度。
當給定位元組在給定字元集中不成立時,該建構子的行為未被指定。
java.nio.charset.CharsetDecoder當需要對解碼過程有更多控制時,應使用此類別。
在 1.1 版本中加入。
Java 文件 java.lang.String.String(byte[], java.lang.String)。
此頁面的部分是根據 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 字元集用於解碼 bytes
- 屬性
例外狀況
如果 byteCount data.length
如果 data == null
備註
透過使用指定的 java.nio.charset.Charset 字元組解碼指定的子陣列來構造一個新字 String 元組。 新 String 的長度是字元集的函數,因此可能不等於子陣列的長度。
此方法總是將錯誤輸入與不可映射字元序列替換為該字元集的預設替換字串。
java.nio.charset.CharsetDecoder當需要對解碼過程有更多控制時,應使用此類別。
新增於1.6版本。
Java 文件 java.lang.String.String(byte[], int, int, java.nio.charset.Charset)。
此頁面的部分是根據 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 字元集用於解碼 bytes
- 屬性
例外狀況
如果 data == null
備註
透過使用指定的 java.nio.charset.Charset 字元集解碼指定的位元組陣列來構造一個新字 String 元。 新 String 的長度是字元集的函數,因此可能不等於位元組陣列的長度。
此方法總是將錯誤輸入與不可映射字元序列替換為該字元集的預設替換字串。
java.nio.charset.CharsetDecoder當需要對解碼過程有更多控制時,應使用此類別。
新增於1.6版本。
Java 文件 java.lang.String.String(byte[], java.nio.charset.Charset)。
此頁面的部分是根據 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的 s。
[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 文件 java.lang.String.String(.*byte[])。
此頁面的部分是根據 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 構成而成,使得:
<引用>
<b><i>c</i></b> == (char)(((hibyte & 0xff) << 8)
| (<b><i>b</i></b> & 0xff))
</區塊引用>
此會員已被棄用。 此方法無法正確將位元組轉換為字元。 截至JDK 1.1 中,首選方式是使用 String 取 java.nio.charset.Charset、字元集名稱的建構子,或使用平台預設字元集。
Java 文件 java.lang.String.String(.*byte[], .*int)。
此頁面的部分是根據 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
A StringBuilder
- 屬性
例外狀況
如果 stringBuilder == null。
備註
分配一個新字串,包含目前字串建構參數中所包含的字元序列。 字串建構器的內容會被複製;後續對弦組器的修改不會影響新建的弦。
此建構子旨在簡化遷移至 StringBuilder。 透過此 toString 方法向弦線製作者取得弦線通常會更快,且通常較為理想。
已在1.5中新增。
Java 文件 java.lang.String.String(java.lang.StringBuilder)。
此頁面的部分是根據 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
A StringBuffer
- 屬性
備註
分配一個新字串,包含目前字串緩衝區參數中所包含的字元序列。 字串緩衝區的內容會被複製;後續對字串緩衝區的修改不會影響新建立的字串。
Java 文件 java.lang.String.String(java.lang.StringBuffer)。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。