語言

String 建構函式

定義

多載

名稱 Description
String()

會產生一個空字串。

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

透過解碼指定的字元組子陣列來構造新字 String 元。

String(Byte[], Int32, Int32, Int32)
已淘汰.

由一個 8 位元整數陣列的子陣列配置一個新 String 建構的

String(Int32[], Int32, Int32)

分配一個包含 Unicode 代碼點陣列參數子陣列字元的新資料 String 。

String(Char[], Int32, Int32)

初始化此字串以包含給定 char的 s。

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的 s。

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 文件 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 &amp; 0xff) &lt;&lt; 8)
                                    | (<b><i>b</i></b> &amp; 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 屬性授權中所述的詞彙使用。

適用於