String Construtores

Definição

Namespace:: Java.Lang

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Sobrecargas

Nome	Description
String()	Cria uma cadeia de caracteres vazia.
String(Byte[], Int32, Int32, String)	Constrói um novo `String` decodificação da subarray especificada de bytes usando o conjunto de caracteres especificado.
String(Byte[], Int32, Int32, Int32)	Obsoleto. Aloca um novo `String` construído a partir de uma subarray de uma matriz de valores inteiros de 8 bits.
String(Byte[], Int32, Int32, Charset)	Constrói um novo `String` decodificação da subarray especificada de bytes usando o java especificado.
String(Char[], Int32, Int32)	Inicializa essa cadeia de caracteres para conter os s especificados `char`.
String(Byte[], Int32, Int32)	Constrói um novo `String` decodificação da subarray especificada de bytes usando o conjunto de caracteres padrão da plataforma.
String(Byte[], String)	Constrói um novo `String` decodificação da matriz de bytes especificada usando o java especificado.
String(Int32[], Int32, Int32)	Aloca um novo `String` que contém caracteres de uma subarray do argumento de matriz de ponto de código Unicode.
String(Byte[], Charset)	Constrói um novo `String` decodificação da matriz de bytes especificada usando o java especificado.
String(String)	Constrói uma nova cadeia de caracteres com a mesma sequência de caracteres `toCopy`que .
String(Char[])	Inicializa essa cadeia de caracteres para conter os s especificados `char`.
String(Byte[])	Constrói um novo `String` decodificação da matriz de bytes especificada usando o conjunto de caracteres padrão da plataforma.
String(StringBuilder)	Aloca uma nova cadeia de caracteres que contém a sequência de caracteres atualmente contida no argumento do construtor de cadeias de caracteres.
String(StringBuffer)	Aloca uma nova cadeia de caracteres que contém a sequência de caracteres atualmente contida no argumento de buffer de cadeia de caracteres.
String(Byte[], Int32)	Obsoleto. Aloca um novo `String` caractere contendo caracteres construídos a partir de uma matriz de valores inteiros de 8 bits.

String()

Cria uma cadeia de caracteres vazia.

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

Atributos: RegisterAttribute

Comentários

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.

Aplica-se a

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

Constrói um novo String decodificação da subarray especificada de bytes usando o conjunto de caracteres especificado.

[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

Parâmetros

bytes: Byte[]

Os bytes a serem decodificados em caracteres

offset: Int32

O índice do primeiro byte a ser decodificado

length: Int32

O número de bytes a serem decodificados

charsetName: String

O nome de um charset java.nio.charset.Charset com suporte

Atributos: RegisterAttribute

Exceções

NullPointerException

if data == null.

IndexOutOfBoundsException

if byteCount data.length.

UnsupportedEncodingException

se não houver suporte para o conjunto de caracteres nomeado.

Comentários

Documentação Java para java.lang.String.String(byte[], int, int, java.lang.String).

Aplica-se a

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

Cuidado

deprecated

Aloca um novo String construído a partir de uma subarray de uma matriz de valores inteiros de 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

Parâmetros

ascii: Byte[]

Os bytes a serem convertidos em caracteres

hibyte: Int32

Os oito primeiros bits de cada unidade de código Unicode de 16 bits

offset: Int32

O deslocamento inicial

count: Int32

O comprimento

Atributos: RegisterAttribute ObsoleteAttribute

Exceções

NullPointerException

if data == null.

IndexOutOfBoundsException

se byteCount data.length

Comentários

Aloca um novo String construído a partir de uma subarray de uma matriz de valores inteiros de 8 bits.

O offset argumento é o índice do primeiro byte da subarray e o count argumento especifica o comprimento da subarray.

Cada byte uma na subarray é convertida em uma char conforme especificado no #String(byte[],int) String(byte[],int) construtor.

Este membro foi preterido. Esse método não converte corretamente bytes em caracteres. A partir do JDK 1.1, a maneira preferencial de fazer isso é por meio dos String construtores que usam um java.nio.charset.Charsetnome de conjunto de caracteres ou que usam o conjunto de caracteres padrão da plataforma.

Documentação Java para java.lang.String.String(.*byte[], .*int, .*int, .*int).

Aplica-se a

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

Constrói um novo String decodificação da subarray especificada de bytes usando o java especificado.

[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

Parâmetros

bytes: Byte[]

Os bytes a serem decodificados em caracteres

offset: Int32

O índice do primeiro byte a ser decodificado

length: Int32

O número de bytes a serem decodificados

charset: Charset

O conjunto de caracteres java.nio.charset.Charset a ser usado para decodificar o bytes

Atributos: RegisterAttribute

Exceções

IndexOutOfBoundsException

se byteCount data.length

NullPointerException

se data == null

Comentários

Constrói um novo String decodificação da subarray especificada de bytes usando o charset java.nio.charset.Charset especificado. O comprimento do novo String é uma função do conjunto de caracteres e, portanto, pode não ser igual ao comprimento da subarray.

Esse método sempre substitui sequências de caracteres de entrada malformada e não aplicaíveis pela cadeia de caracteres de substituição padrão desse conjunto de caracteres. A java.nio.charset.CharsetDecoder classe deve ser usada quando for necessário mais controle sobre o processo de decodificação.

Adicionado em 1.6.

Documentação Java para java.lang.String.String(byte[], int, int, java.nio.charset.Charset).

Aplica-se a

String(Char[], Int32, Int32)

Inicializa essa cadeia de caracteres para conter os s especificados 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

Parâmetros

data: Char[]

A matriz de caracteres usada para inicializar a cadeia de caracteres.

offset: Int32

O deslocamento no qual a operação é executada.

charCount: Int32

O número de caracteres a serem usados da matriz.

Atributos: RegisterAttribute

Exceções

NullPointerException

if data == null.

IndexOutOfBoundsException

se charCount data.length

Comentários

Aplica-se a

String(Byte[], Int32, Int32)

Constrói um novo String decodificação da subarray especificada de bytes usando o conjunto de caracteres padrão da plataforma.

[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

Parâmetros

bytes: Byte[]

Os bytes a serem decodificados em caracteres

offset: Int32

O índice do primeiro byte a ser decodificado

length: Int32

O número de bytes a serem decodificados

Atributos: RegisterAttribute

Exceções

NullPointerException

if data == null.

IndexOutOfBoundsException

if byteCount data.length.

Comentários

Constrói um novo String decodificação da subarray especificada de bytes usando o conjunto de caracteres padrão da plataforma. O comprimento do novo String é uma função do conjunto de caracteres e, portanto, pode não ser igual ao comprimento da subarray.

O comportamento desse construtor quando os bytes determinados não são válidos no conjunto de caracteres padrão não é especificado. A java.nio.charset.CharsetDecoder classe deve ser usada quando for necessário mais controle sobre o processo de decodificação.

Adicionado em 1.1.

Documentação Java para java.lang.String.String(.*byte[], .*int, .*int).

Aplica-se a

String(Byte[], String)

Constrói um novo String decodificação da matriz de bytes especificada usando o java especificado.

[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

Parâmetros

bytes: Byte[]

Os bytes a serem decodificados em caracteres

charsetName: String

O nome de um charset java.nio.charset.Charset com suporte

Atributos: RegisterAttribute

Exceções

NullPointerException

if data == null.

UnsupportedEncodingException

se charsetName não houver suporte.

Comentários

Constrói um novo String decodificação da matriz de bytes especificada usando o charset java.nio.charset.Charset especificado. O comprimento do novo String é uma função do conjunto de caracteres e, portanto, pode não ser igual ao comprimento da matriz de bytes.

O comportamento desse construtor quando os bytes determinados não são válidos no conjunto de caracteres especificado não é especificado. A java.nio.charset.CharsetDecoder classe deve ser usada quando for necessário mais controle sobre o processo de decodificação.

Adicionado em 1.1.

Documentação Java para java.lang.String.String(byte[], java.lang.String).

Aplica-se a

String(Int32[], Int32, Int32)

Aloca um novo String que contém caracteres de uma subarray do argumento de matriz de ponto de código 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

Parâmetros

codePoints: Int32[]

Matriz que é a origem dos pontos de código Unicode

offset: Int32

O deslocamento inicial

count: Int32

O comprimento

Atributos: RegisterAttribute

Exceções

NullPointerException

if codePoints == null.

IllegalArgumentException

se qualquer um dos elementos não forem pontos de codePoints código Unicode válidos.

IndexOutOfBoundsException

se offset estiver ou count não dentro dos limites de codePoints.

Comentários

Aloca um novo String que contém caracteres de uma subarray do argumento de matriz de ponto de código Unicode. O offset argumento é o índice do primeiro ponto de código da subarray e o count argumento especifica o comprimento da subarray. O conteúdo da subarray é convertido charem s; a modificação subsequente da int matriz não afeta a cadeia de caracteres recém-criada.

Adicionado em 1.5.

Documentação Java para java.lang.String.String(.*int[], .*int, .*int).

Aplica-se a

String(Byte[], Charset)

Constrói um novo String decodificação da matriz de bytes especificada usando o java especificado.

[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

Parâmetros

bytes: Byte[]

Os bytes a serem decodificados em caracteres

charset: Charset

O conjunto de caracteres java.nio.charset.Charset a ser usado para decodificar o bytes

Atributos: RegisterAttribute

Exceções

NullPointerException

se data == null

Comentários

Adicionado em 1.6.

Documentação Java para java.lang.String.String(byte[], java.nio.charset.Charset).

Aplica-se a

String(String)

Constrói uma nova cadeia de caracteres com a mesma sequência de caracteres toCopyque .

[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

Parâmetros

toCopy: String

A cadeia de caracteres cujos caracteres inicializam a nova cadeia de caracteres.

Atributos: RegisterAttribute

Comentários

Aplica-se a

String(Char[])

Inicializa essa cadeia de caracteres para conter os s especificados 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

Parâmetros

data: Char[]

A matriz de caracteres usada para inicializar a cadeia de caracteres.

Atributos: RegisterAttribute

Exceções

NullPointerException

se data == null

Comentários

Aplica-se a

String(Byte[])

Constrói um novo String decodificação da matriz de bytes especificada usando o conjunto de caracteres padrão da plataforma.

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

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

Parâmetros

bytes: Byte[]

Os bytes a serem decodificados em caracteres

Atributos: RegisterAttribute

Comentários

Constrói um novo String decodificação da matriz de bytes especificada usando o conjunto de caracteres padrão da plataforma. O comprimento do novo String é uma função do conjunto de caracteres e, portanto, pode não ser igual ao comprimento da matriz de bytes.

Adicionado em 1.1.

Documentação Java para java.lang.String.String(.*byte[]).

Aplica-se a

String(StringBuilder)

Aloca uma nova cadeia de caracteres que contém a sequência de caracteres atualmente contida no argumento do construtor de cadeias de caracteres.

[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

Parâmetros

builder: StringBuilder

Uma StringBuilder

Atributos: RegisterAttribute

Exceções

NullPointerException

if stringBuilder == null.

Comentários

Aloca uma nova cadeia de caracteres que contém a sequência de caracteres atualmente contida no argumento do construtor de cadeias de caracteres. O conteúdo do construtor de cadeias de caracteres é copiado; A modificação subsequente do construtor de cadeias de caracteres não afeta a cadeia de caracteres recém-criada.

Esse construtor é fornecido para facilitar a migração para StringBuilder. A obtenção de uma cadeia de caracteres de um construtor de cadeias de caracteres por meio do toString método provavelmente será executada mais rapidamente e geralmente é preferível.

Adicionado em 1.5.

Documentação Java para java.lang.String.String(java.lang.StringBuilder).

Aplica-se a

String(StringBuffer)

Aloca uma nova cadeia de caracteres que contém a sequência de caracteres atualmente contida no argumento de buffer de cadeia de caracteres.

[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

Parâmetros

buffer: StringBuffer

Uma StringBuffer

Atributos: RegisterAttribute

Comentários

Aloca uma nova cadeia de caracteres que contém a sequência de caracteres atualmente contida no argumento de buffer de cadeia de caracteres. O conteúdo do buffer de cadeia de caracteres é copiado; a modificação subsequente do buffer de cadeia de caracteres não afeta a cadeia de caracteres recém-criada.

Documentação Java para java.lang.String.String(java.lang.StringBuffer).

Aplica-se a

String(Byte[], Int32)

Cuidado

deprecated

Aloca um novo String caractere contendo caracteres construídos a partir de uma matriz de valores inteiros de 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

Parâmetros

ascii: Byte[]

Os bytes a serem convertidos em caracteres

hibyte: Int32

Os oito primeiros bits de cada unidade de código Unicode de 16 bits

Atributos: RegisterAttribute ObsoleteAttribute

Exceções

NullPointerException

if data == null.

Comentários

Aloca um novo String caractere contendo caracteres construídos a partir de uma matriz de valores inteiros de 8 bits. Cada caractere c na cadeia de caracteres resultante é construído a partir do componente correspondente b na matriz de bytes de modo que:

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

</blockquote>

Documentação Java para java.lang.String.String(.*byte[], .*int).

Aplica-se a