Freigeben über

String Konstruktoren

  • Referenz

Definition

Namespace:
Java.Lang
Assembly:
Mono.Android.dll

Überlädt

String()

Erstellt eine leere Zeichenfolge.
String(Byte[], Int32, Int32, String)

Erstellt ein neues String , indem das angegebene Unterarray von Bytes mithilfe des angegebenen Zeichensatzes decodiert wird.
String(Byte[], Int32, Int32, Int32)
Veraltet.

Ordnet ein neues String zu, das aus einem Subarray eines Arrays mit ganzzahligen 8-Bit-Werten erstellt wurde.
String(Int32[], Int32, Int32)

Ordnet eine neue String zu, die Zeichen aus einem Subarray des Unicode-Codepunktarrayarguments enthält.
String(Char[], Int32, Int32)

Initialisiert diese Zeichenfolge, um die angegebenen chars zu enthalten.
String(Byte[], Int32, Int32)

Erstellt ein neues String , indem das angegebene Unterarray von Bytes mithilfe des Standardzeichensatzes der Plattform decodiert wird.
String(Byte[], String)

Erstellt ein neues String , indem das angegebene Bytearray mithilfe des angegebenen Java decodiert wird.
String(Byte[], Int32, Int32, Charset)

Erstellt ein neues String , indem das angegebene Unterarray von Bytes mit dem angegebenen Java decodiert wird.
String(Byte[], Charset)

Erstellt ein neues String , indem das angegebene Bytearray mithilfe des angegebenen Java decodiert wird.
String(String)

Erstellt eine neue Zeichenfolge mit der gleichen Zeichenfolge wie toCopy.
String(Char[])

Initialisiert diese Zeichenfolge, um die angegebenen chars zu enthalten.
String(Byte[])

Erstellt ein neues String , indem das angegebene Bytearray mithilfe des Standardzeichensatzes der Plattform decodiert wird.
String(Byte[], Int32)
Veraltet.

Weist ein neues String Zeichen zu, das aus einem Array von ganzzahligen 8-Bit-Werten erstellt wurde.
String(StringBuilder)

Weist eine neue Zeichenfolge zu, die die Sequenz von Zeichen enthält, die derzeit im Zeichenfolgen-Generator-Argument enthalten ist.
String(StringBuffer)

Weist eine neue Zeichenfolge zu, die die Sequenz von Zeichen enthält, die derzeit im Zeichenfolgenpufferargument enthalten sind.

String()

Erstellt eine leere Zeichenfolge.

[Android.Runtime.Register(".ctor", "()V", "")]
public String ();
Attribute
RegisterAttribute

Hinweise

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In der Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

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

Erstellt ein neues String , indem das angegebene Unterarray von Bytes mithilfe des angegebenen Zeichensatzes decodiert wird.

[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

Parameter

bytes
Byte[]

Die Bytes, die in Zeichen decodiert werden sollen

offset
Int32

Der Index des ersten zu decodierenden Byte

length
Int32

Die Anzahl der zu decodierenden Bytes

charsetName
String

Der Name eines unterstützten java.nio.charset.Charset-Charset-Zeichensatzes

Attribute
RegisterAttribute

Ausnahmen

NullPointerException

, wenn data == null.

IndexOutOfBoundsException

, wenn byteCount data.length.

UnsupportedEncodingException

, wenn das benannte Zeichensatz nicht unterstützt wird.

Hinweise

Java-Dokumentation für java.lang.String.String(byte[], int, int, java.lang.String).

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In der Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

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

Achtung

deprecated

Ordnet ein neues String zu, das aus einem Subarray eines Arrays mit ganzzahligen 8-Bit-Werten erstellt wurde.

[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

Parameter

ascii
Byte[]

Die Bytes, die in Zeichen konvertiert werden sollen

hibyte
Int32

Die obersten 8 Bits jeder 16-Bit-Unicode-Codeeinheit

offset
Int32

Der anfängliche Offset

count
Int32

Die Länge

Attribute
RegisterAttribute ObsoleteAttribute

Ausnahmen

NullPointerException

, wenn data == null.

IndexOutOfBoundsException

if byteCount data.length

Hinweise

Ordnet ein neues String zu, das aus einem Subarray eines Arrays mit ganzzahligen 8-Bit-Werten erstellt wurde.

Das offset Argument ist der Index des ersten Byte des Subarrays, und das count Argument gibt die Länge des Subarrays an.

Jedes byte im Subarray wird wie im Konstruktor angegeben in #String(byte[],int) String(byte[],int) ein char konvertiert.

Dieses Member ist veraltet. Diese Methode konvertiert Bytes nicht ordnungsgemäß in Zeichen. Ab JDK  1.1. Die bevorzugte Methode hierfür ist die Verwendung der Konstruktoren, die String einen java.nio.charset.Charset, charset-Namen annehmen oder das Standard charset der Plattform verwenden.

Java-Dokumentation für java.lang.String.String(byte[], int, int, int).

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In der Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

String(Int32[], Int32, Int32)

Ordnet eine neue String zu, die Zeichen aus einem Subarray des Unicode-Codepunktarrayarguments enthält.

[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

Parameter

codePoints
Int32[]

Array, das die Quelle von Unicode-Codepunkten ist

offset
Int32

Der anfängliche Offset

count
Int32

Die Länge

Attribute
RegisterAttribute

Ausnahmen

NullPointerException

, wenn codePoints == null.

IllegalArgumentException

, wenn eines der Elemente von codePoints keine gültigen Unicode-Codepunkte sind.

IndexOutOfBoundsException

, wenn offset oder count nicht innerhalb der Grenzen von codePointsliegen.

Hinweise

Ordnet eine neue String zu, die Zeichen aus einem Subarray des Unicode-Codepunktarrayarguments enthält. Das offset Argument ist der Index des ersten Codepunkts des Subarrays, und das count Argument gibt die Länge des Subarrays an. Der Inhalt des Subarrays wird in chars konvertiert. Eine nachfolgende Änderung des int Arrays wirkt sich nicht auf die neu erstellte Zeichenfolge aus.

Hinzugefügt in 1.5.

Java-Dokumentation für java.lang.String.String(int[], int, int).

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In der Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

String(Char[], Int32, Int32)

Initialisiert diese Zeichenfolge, um die angegebenen chars zu enthalten.

[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

Parameter

data
Char[]
offset
Int32
charCount
Int32
Attribute
RegisterAttribute

Ausnahmen

NullPointerException

, wenn data == null.

IndexOutOfBoundsException

if charCount data.length

Hinweise

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In der Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

String(Byte[], Int32, Int32)

Erstellt ein neues String , indem das angegebene Unterarray von Bytes mithilfe des Standardzeichensatzes der Plattform decodiert wird.

[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

Parameter

bytes
Byte[]

Die Bytes, die in Zeichen decodiert werden sollen

offset
Int32

Der Index des ersten zu decodierenden Byte

length
Int32

Die Anzahl der zu decodierenden Bytes

Attribute
RegisterAttribute

Ausnahmen

NullPointerException

, wenn data == null.

IndexOutOfBoundsException

, wenn byteCount data.length.

Hinweise

Erstellt ein neues String , indem das angegebene Unterarray von Bytes mithilfe des Standardzeichensatzes der Plattform decodiert wird. Die Länge des neuen String ist eine Funktion des Zeichensatzes und ist daher möglicherweise nicht gleich der Länge des Subarrays.

Das Verhalten dieses Konstruktors, wenn die angegebenen Bytes im Standardzeichensatz ungültig sind, ist nicht angegeben. Die java.nio.charset.CharsetDecoder -Klasse sollte verwendet werden, wenn mehr Kontrolle über den Decodierungsprozess erforderlich ist.

In Version 1.1 hinzugefügt.

Java-Dokumentation für java.lang.String.String(byte[], int, int).

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In der Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

String(Byte[], String)

Erstellt eine neue String , indem das angegebene Bytearray mithilfe des angegebenen Java decodiert wird.

[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

Parameter

bytes
Byte[]

Die Bytes, die in Zeichen decodiert werden sollen

charsetName
String

Der Name eines unterstützten java.nio.charset.Charset-Charset-Zeichensatzes

Attribute
RegisterAttribute

Ausnahmen

NullPointerException

, wenn data == null.

UnsupportedEncodingException

, wenn charsetName nicht unterstützt wird.

Hinweise

Erstellt ein neues String , indem das angegebene Array von Bytes mit dem angegebenen java.nio.charset.Charset-Zeichensatz decodiert wird. Die Länge des neuen String ist eine Funktion des Zeichensatzes und ist daher möglicherweise nicht gleich der Länge des Bytearrays.

Das Verhalten dieses Konstruktors, wenn die angegebenen Bytes im angegebenen Zeichensatz ungültig sind, ist nicht angegeben. Die java.nio.charset.CharsetDecoder -Klasse sollte verwendet werden, wenn mehr Kontrolle über den Decodierungsprozess erforderlich ist.

In Version 1.1 hinzugefügt.

Java-Dokumentation für java.lang.String.String(byte[], java.lang.String).

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

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

Erstellt eine neue String , indem das angegebene Unterarray von Bytes mithilfe des angegebenen Java decodiert wird.

[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

Parameter

bytes
Byte[]

Die Bytes, die in Zeichen decodiert werden sollen

offset
Int32

Der Index des ersten zu decodierenden Bytes

length
Int32

Die Anzahl der zu decodierenden Bytes

charset
Charset

Das java.nio.charset.Charset-Zeichenset, das zum Decodieren von verwendet werden soll. bytes

Attribute
RegisterAttribute

Ausnahmen

IndexOutOfBoundsException

if byteCount data.length

NullPointerException

if data == null

Hinweise

Erstellt eine neue String , indem das angegebene Unterarray von Bytes mit dem angegebenen java.nio.charset.Charset-Zeichensatz decodiert wird. Die Länge des neuen String ist eine Funktion des Zeichensatzes und ist daher möglicherweise nicht gleich der Länge des Subarrays.

Diese Methode ersetzt immer falsch formatierte eingabe- und nicht verwendbare Zeichensequenzen durch die Standardersetzungszeichenfolge dieses Zeichensatzes. Die java.nio.charset.CharsetDecoder -Klasse sollte verwendet werden, wenn mehr Kontrolle über den Decodierungsprozess erforderlich ist.

In Version 1.6 hinzugefügt.

Java-Dokumentation für java.lang.String.String(byte[], int, int, java.nio.charset.Charset).

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

String(Byte[], Charset)

Erstellt eine neue String , indem das angegebene Bytearray mithilfe des angegebenen Java decodiert wird.

[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

Parameter

bytes
Byte[]

Die Bytes, die in Zeichen decodiert werden sollen

charset
Charset

Das java.nio.charset.Charset-Zeichenset, das zum Decodieren von verwendet werden soll. bytes

Attribute
RegisterAttribute

Ausnahmen

NullPointerException

if data == null

Hinweise

Erstellt eine neue String , indem das angegebene Bytearray mit dem angegebenen java.nio.charset.Charset-Zeichensatz decodiert wird. Die Länge des neuen String ist eine Funktion des Zeichensatzes und ist daher möglicherweise nicht gleich der Länge des Bytearrays.

Diese Methode ersetzt immer falsch formatierte eingabe- und nicht verwendbare Zeichensequenzen durch die Standardersetzungszeichenfolge dieses Zeichensatzes. Die java.nio.charset.CharsetDecoder -Klasse sollte verwendet werden, wenn mehr Kontrolle über den Decodierungsprozess erforderlich ist.

In Version 1.6 hinzugefügt.

Java-Dokumentation für java.lang.String.String(byte[], java.nio.charset.Charset).

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

String(String)

Erstellt eine neue Zeichenfolge mit derselben Sequenz von Zeichen wie 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

Parameter

toCopy
String
Attribute
RegisterAttribute

Hinweise

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

String(Char[])

Initialisiert diese Zeichenfolge, um die angegebenen chars zu enthalten.

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

Parameter

data
Char[]
Attribute
RegisterAttribute

Ausnahmen

NullPointerException

if data == null

Hinweise

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

String(Byte[])

Erstellt eine neue String , indem das angegebene Bytearray mithilfe des Standardzeichensatzes der Plattform decodiert wird.

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

Parameter

bytes
Byte[]

Die Bytes, die in Zeichen decodiert werden sollen

Attribute
RegisterAttribute

Hinweise

Erstellt eine neue String , indem das angegebene Bytearray mithilfe des Standardzeichensatzes der Plattform decodiert wird. Die Länge des neuen String ist eine Funktion des Zeichensatzes und ist daher möglicherweise nicht gleich der Länge des Bytearrays.

Das Verhalten dieses Konstruktors, wenn die angegebenen Bytes im Standardzeichensatz ungültig sind, ist nicht angegeben. Die java.nio.charset.CharsetDecoder -Klasse sollte verwendet werden, wenn mehr Kontrolle über den Decodierungsprozess erforderlich ist.

In Version 1.1 hinzugefügt.

Java-Dokumentation für java.lang.String.String(byte[]).

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

String(Byte[], Int32)

Achtung

deprecated

Weist eine neue String mit Zeichen zu, die aus einem Array von 8-Bit-Ganzzahlwerten erstellt wurden.

[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

Parameter

ascii
Byte[]

Die Bytes, die in Zeichen konvertiert werden sollen

hibyte
Int32

Die obersten 8 Bits jeder 16-Bit-Unicode-Codeeinheit

Attribute
RegisterAttribute ObsoleteAttribute

Ausnahmen

NullPointerException

, wenn data == null.

Hinweise

Weist eine neue String mit Zeichen zu, die aus einem Array von 8-Bit-Ganzzahlwerten erstellt wurden. Jedes Zeichen c in der resultierenden Zeichenfolge wird aus der entsprechenden Komponente b im Bytearray so konstruiert, dass:

<Blockquote>

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

</Blockquote>

Dieses Member ist veraltet. Diese Methode konvertiert Bytes nicht ordnungsgemäß in Zeichen. Ab JDK  1.1. Die bevorzugte Methode hierfür ist die Verwendung der String Konstruktoren, die einen java.nio.charset.Charset, Zeichensatznamen oder das Standardzeichensatz der Plattform verwenden.

Java-Dokumentation für java.lang.String.String(byte[], int).

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

String(StringBuilder)

Ordnet eine neue Zeichenfolge zu, die die Sequenz von Zeichen enthält, die derzeit im Zeichenfolgen-Generator-Argument enthalten ist.

[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

Parameter

builder
StringBuilder

Eine StringBuilder

Attribute
RegisterAttribute

Ausnahmen

NullPointerException

, wenn stringBuilder == null.

Hinweise

Ordnet eine neue Zeichenfolge zu, die die Sequenz von Zeichen enthält, die derzeit im Zeichenfolgen-Generator-Argument enthalten ist. Der Inhalt des Zeichenfolgen-Generators wird kopiert. Nachfolgende Änderungen des Zeichenfolgen-Generators wirken sich nicht auf die neu erstellte Zeichenfolge aus.

Dieser Konstruktor wird bereitgestellt, um die Migration zu zu vereinfachen StringBuilder. Das Abrufen einer Zeichenfolge von einem Zeichenfolgen-Generator über die toString -Methode wird wahrscheinlich schneller ausgeführt und wird im Allgemeinen bevorzugt.

Hinzugefügt in 1.5.

Java-Dokumentation für java.lang.String.String(java.lang.StringBuilder).

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

String(StringBuffer)

Weist eine neue Zeichenfolge zu, die die Sequenz von Zeichen enthält, die derzeit im Zeichenfolgenpufferargument enthalten sind.

[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

Parameter

buffer
StringBuffer

Eine StringBuffer

Attribute
RegisterAttribute

Hinweise

Weist eine neue Zeichenfolge zu, die die Sequenz von Zeichen enthält, die derzeit im Zeichenfolgenpufferargument enthalten sind. Der Inhalt des Zeichenfolgenpuffers wird kopiert. Nachfolgende Änderungen des Zeichenfolgenpuffers wirken sich nicht auf die neu erstellte Zeichenfolge aus.

Java-Dokumentation für java.lang.String.String(java.lang.StringBuffer).

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: