String Constructeurs

Définition

Espace de noms:: Java.Lang

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Surcharges

Nom	Description
String()	Crée une chaîne vide.
String(Byte[], Int32, Int32, String)	Construit un nouveau en `String` décodant le sous-narrateur spécifié d’octets à l’aide de l’ensemble de caractères spécifié.
String(Byte[], Int32, Int32, Int32)	Obsolète. Alloue une nouvelle `String` construction à partir d’un sous-tableau de valeurs entières 8 bits.
String(Byte[], Int32, Int32, Charset)	Construit un nouveau en `String` décodant le sous-narrateur spécifié d’octets à l’aide du java spécifié.
String(Char[], Int32, Int32)	Initialise cette chaîne pour contenir les s donnés `char`.
String(Byte[], Int32, Int32)	Construit un nouveau en `String` décodant le sous-narrateur spécifié d’octets à l’aide de l’ensemble de caractères par défaut de la plateforme.
String(Byte[], String)	Construit un nouveau en `String` décodant le tableau d’octets spécifié à l’aide du java spécifié.
String(Int32[], Int32, Int32)	Alloue un nouveau `String` qui contient des caractères à partir d’un sous-narrateur de l’argument de tableau de points de code Unicode.
String(Byte[], Charset)	Construit un nouveau en `String` décodant le tableau d’octets spécifié à l’aide du java spécifié.
String(String)	Construit une nouvelle chaîne avec la même séquence de caractères que `toCopy`.
String(Char[])	Initialise cette chaîne pour contenir les s donnés `char`.
String(Byte[])	Construit un nouveau en `String` décodant le tableau d’octets spécifié à l’aide du charset par défaut de la plateforme.
String(StringBuilder)	Alloue une nouvelle chaîne qui contient la séquence de caractères actuellement contenue dans l’argument du générateur de chaînes.
String(StringBuffer)	Alloue une nouvelle chaîne qui contient la séquence de caractères actuellement contenue dans l’argument de mémoire tampon de chaîne.
String(Byte[], Int32)	Obsolète. Alloue un nouveau `String` caractère contenant des caractères construits à partir d’un tableau de valeurs entières 8 bits.

String()

Crée une chaîne vide.

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

Attributs: RegisterAttribute

Remarques

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

S’applique à

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

Construit un nouveau en String décodant le sous-narrateur spécifié d’octets à l’aide de l’ensemble de caractères spécifié.

[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

Paramètres

bytes: Byte[]

Octets à décoder en caractères

offset: Int32

Index du premier octet à décoder

length: Int32

Nombre d’octets à décoder

charsetName: String

Nom d’un ensemble de caractères java.nio.charset.Charset pris en charge

Attributs: RegisterAttribute

Exceptions

NullPointerException

si data == null.

IndexOutOfBoundsException

si byteCount data.length.

UnsupportedEncodingException

si l’ensemble de caractères nommé n’est pas pris en charge.

Remarques

Java documentation pour java.lang.String.String(byte[], int, int, java.lang.String).

S’applique à

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

Attention

deprecated

Alloue une nouvelle String construction à partir d’un sous-tableau de valeurs entières 8 bits.

[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

Paramètres

ascii: Byte[]

Octets à convertir en caractères

hibyte: Int32

Les 8 premiers bits de chaque unité de code Unicode 16 bits

offset: Int32

Décalage initial

count: Int32

Longueur

Attributs: RegisterAttribute ObsoleteAttribute

Exceptions

NullPointerException

si data == null.

IndexOutOfBoundsException

si byteCount data.length

Remarques

Alloue une nouvelle String construction à partir d’un sous-tableau de valeurs entières 8 bits.

L’argument offset est l’index du premier octet du sous-tableau, et l’argument count spécifie la longueur du sous-narrateur.

Chacun byte dans le sous-tableau est converti en un char tel qu’il est spécifié dans le #String(byte[],int) String(byte[],int) constructeur.

Ce membre est déconseillé. Cette méthode ne convertit pas correctement les octets en caractères. A partir de JDK ; 1.1, la méthode recommandée consiste à utiliser les String constructeurs qui prennent un java.nio.charset.Charsetnom de jeu de caractères ou qui utilisent l’ensemble de caractères par défaut de la plateforme.

Java documentation pour java.lang.String.String(.*byte[], .*int, .*int, .*int).

S’applique à

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

Construit un nouveau en String décodant le sous-narrateur spécifié d’octets à l’aide du java spécifié.

[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

Paramètres

bytes: Byte[]

Octets à décoder en caractères

offset: Int32

Index du premier octet à décoder

length: Int32

Nombre d’octets à décoder

charset: Charset

Ensemble de caractères java.nio.charset.Charset à utiliser pour décoder le bytes

Attributs: RegisterAttribute

Exceptions

IndexOutOfBoundsException

si byteCount data.length

NullPointerException

si data == null

Remarques

Construit un nouveau String en décodant le sous-narrateur spécifié d’octets à l’aide du jeu de caractères java.nio.charset.Charset spécifié. La longueur du nouveau String est une fonction de l’ensemble de caractères, et peut donc ne pas être égale à la longueur du sous-narrateur.

Cette méthode remplace toujours les séquences de caractères incorrectes et non formées par la chaîne de remplacement par défaut de cet ensemble de caractères. La java.nio.charset.CharsetDecoder classe doit être utilisée lorsque davantage de contrôle sur le processus de décodage est nécessaire.

Ajouté dans la version 1.6.

Java documentation pour java.lang.String.String(byte[], int, int, java.nio.charset.Charset).

S’applique à

String(Char[], Int32, Int32)

Initialise cette chaîne pour contenir les s donnés 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

Paramètres

data: Char[]

Tableau de caractères utilisé pour initialiser la chaîne.

offset: Int32

Décalage auquel l’opération est effectuée.

charCount: Int32

Nombre de caractères à utiliser à partir du tableau.

Attributs: RegisterAttribute

Exceptions

NullPointerException

si data == null.

IndexOutOfBoundsException

si charCount data.length

Remarques

S’applique à

String(Byte[], Int32, Int32)

Construit un nouveau en String décodant le sous-narrateur spécifié d’octets à l’aide de l’ensemble de caractères par défaut de la plateforme.

[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

Paramètres

bytes: Byte[]

Octets à décoder en caractères

offset: Int32

Index du premier octet à décoder

length: Int32

Nombre d’octets à décoder

Attributs: RegisterAttribute

Exceptions

NullPointerException

si data == null.

IndexOutOfBoundsException

si byteCount data.length.

Remarques

Construit un nouveau en String décodant le sous-narrateur spécifié d’octets à l’aide de l’ensemble de caractères par défaut de la plateforme. La longueur du nouveau String est une fonction de l’ensemble de caractères, et peut donc ne pas être égale à la longueur du sous-narrateur.

Le comportement de ce constructeur lorsque les octets donnés ne sont pas valides dans l’ensemble de caractères par défaut n’est pas spécifié. La java.nio.charset.CharsetDecoder classe doit être utilisée lorsque davantage de contrôle sur le processus de décodage est nécessaire.

Ajouté dans la version 1.1.

Java documentation pour java.lang.String.String(.*byte[], .*int, .*int).

S’applique à

String(Byte[], String)

Construit un nouveau en String décodant le tableau d’octets spécifié à l’aide du java spécifié.

[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

Paramètres

bytes: Byte[]

Octets à décoder en caractères

charsetName: String

Nom d’un ensemble de caractères java.nio.charset.Charset pris en charge

Attributs: RegisterAttribute

Exceptions

NullPointerException

si data == null.

UnsupportedEncodingException

s’il charsetName n’est pas pris en charge.

Remarques

Construit un nouveau en String décodant le tableau d’octets spécifié à l’aide du jeu de caractères java.nio.charset.Charset spécifié. La longueur du nouveau String est une fonction de l’ensemble de caractères, et peut donc ne pas être égale à la longueur du tableau d’octets.

Le comportement de ce constructeur lorsque les octets donnés ne sont pas valides dans l’ensemble de caractères donné n’est pas spécifié. La java.nio.charset.CharsetDecoder classe doit être utilisée lorsque davantage de contrôle sur le processus de décodage est nécessaire.

Ajouté dans la version 1.1.

Java documentation pour java.lang.String.String(byte[], java.lang.String).

S’applique à

String(Int32[], Int32, Int32)

Alloue un nouveau String qui contient des caractères à partir d’un sous-narrateur de l’argument de tableau de points de code 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

Paramètres

codePoints: Int32[]

Tableau qui est la source des points de code Unicode

offset: Int32

Décalage initial

count: Int32

Longueur

Attributs: RegisterAttribute

Exceptions

NullPointerException

si codePoints == null.

IllegalArgumentException

si l’un des éléments de n’est pas des codePoints points de code Unicode valides.

IndexOutOfBoundsException

si offset ou count ne sont pas dans les limites de codePoints.

Remarques

Alloue un nouveau String qui contient des caractères à partir d’un sous-narrateur de l’argument de tableau de points de code Unicode. L’argument offset est l’index du premier point de code du sous-narrateur et l’argument count spécifie la longueur du sous-narrateur. Le contenu du sous-tableau est converti en chars ; la modification ultérieure du int tableau n’affecte pas la chaîne nouvellement créée.

Ajouté à la version 1.5.

Java documentation pour java.lang.String.String(.*int[], .*int, .*int).

S’applique à

String(Byte[], Charset)

Construit un nouveau en String décodant le tableau d’octets spécifié à l’aide du java spécifié.

[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

Paramètres

bytes: Byte[]

Octets à décoder en caractères

charset: Charset

Ensemble de caractères java.nio.charset.Charset à utiliser pour décoder le bytes

Attributs: RegisterAttribute

Exceptions

NullPointerException

si data == null

Remarques

Ajouté dans la version 1.6.

Java documentation pour java.lang.String.String(byte[], java.nio.charset.Charset).

S’applique à

String(String)

Construit une nouvelle chaîne avec la même séquence de caractères que 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

Paramètres

toCopy: String

Chaîne dont les caractères initialisent la nouvelle chaîne.

Attributs: RegisterAttribute

Remarques

S’applique à

String(Char[])

Initialise cette chaîne pour contenir les s donnés 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

Paramètres

data: Char[]

Tableau de caractères utilisé pour initialiser la chaîne.

Attributs: RegisterAttribute

Exceptions

NullPointerException

si data == null

Remarques

S’applique à

String(Byte[])

Construit un nouveau en String décodant le tableau d’octets spécifié à l’aide du charset par défaut de la plateforme.

[Android.Runtime.Register(".ctor", "([B)V", "")]
public String(byte[]? bytes);

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

Paramètres

bytes: Byte[]

Octets à décoder en caractères

Attributs: RegisterAttribute

Remarques

Construit un nouveau en String décodant le tableau d’octets spécifié à l’aide du charset par défaut de la plateforme. La longueur du nouveau String est une fonction de l’ensemble de caractères, et peut donc ne pas être égale à la longueur du tableau d’octets.

Ajouté dans la version 1.1.

Java documentation pour java.lang.String.String(.*byte[]).

S’applique à

String(StringBuilder)

Alloue une nouvelle chaîne qui contient la séquence de caractères actuellement contenue dans l’argument du générateur de chaînes.

[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

Paramètres

builder: StringBuilder

Un StringBuilder

Attributs: RegisterAttribute

Exceptions

NullPointerException

si stringBuilder == null.

Remarques

Alloue une nouvelle chaîne qui contient la séquence de caractères actuellement contenue dans l’argument du générateur de chaînes. Le contenu du générateur de chaînes est copié ; la modification suivante du générateur de chaînes n’affecte pas la chaîne nouvellement créée.

Ce constructeur est fourni pour faciliter la migration vers StringBuilder. L’obtention d’une chaîne à partir d’un générateur de chaînes via la toString méthode est susceptible d’être exécutée plus rapidement et est généralement préférée.

Ajouté à la version 1.5.

Java documentation pour java.lang.String.String(java.lang.StringBuilder).

S’applique à

String(StringBuffer)

Alloue une nouvelle chaîne qui contient la séquence de caractères actuellement contenue dans l’argument de mémoire tampon de chaîne.

[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

Paramètres

buffer: StringBuffer

Un StringBuffer

Attributs: RegisterAttribute

Remarques

Alloue une nouvelle chaîne qui contient la séquence de caractères actuellement contenue dans l’argument de mémoire tampon de chaîne. Le contenu de la mémoire tampon de chaîne est copié ; la modification suivante de la mémoire tampon de chaîne n’affecte pas la chaîne nouvellement créée.

Java documentation pour java.lang.String.String(java.lang.StringBuffer).

S’applique à

String(Byte[], Int32)

Attention

deprecated

Alloue un nouveau String caractère contenant des caractères construits à partir d’un tableau de valeurs entières 8 bits.

[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

Paramètres

ascii: Byte[]

Octets à convertir en caractères

hibyte: Int32

Les 8 premiers bits de chaque unité de code Unicode 16 bits

Attributs: RegisterAttribute ObsoleteAttribute

Exceptions

NullPointerException

si data == null.

Remarques

Alloue un nouveau String caractère contenant des caractères construits à partir d’un tableau de valeurs entières 8 bits. Chaque caractère c de la chaîne résultante est construit à partir du composant b correspondant dans le tableau d’octets de sorte que :

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

</blockquote>

Java documentation pour java.lang.String.String(.*byte[], .*int).

S’applique à