Lenguaje

String Constructores

Definición

Sobrecargas

Nombre Description
String()

Crea una cadena vacía.

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

Construye un nuevo String descodificar la subbarray especificada de bytes mediante el conjunto de caracteres especificado.

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

Asigna un nuevo String construido a partir de una subbarray de una matriz de valores enteros de 8 bits.

String(Int32[], Int32, Int32)

Asigna un nuevo String que contiene caracteres de una subbarray del argumento de matriz de puntos de código Unicode.

String(Char[], Int32, Int32)

Inicializa esta cadena para que contenga los valores especificados char.

String(Byte[], Int32, Int32)

Construye un nuevo String mediante la descodificación del subbarray especificado de bytes mediante el conjunto de caracteres predeterminado de la plataforma.

String(Byte[], String)

Construye un nuevo String mediante la descodificación de la matriz especificada de bytes mediante el java especificado.

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

Construye un nuevo String mediante la descodificación de la subbarra especificada de bytes mediante el java especificado.

String(Byte[], Charset)

Construye un nuevo String mediante la descodificación de la matriz especificada de bytes mediante el java especificado.

String(String)

Construye una nueva cadena con la misma secuencia de caracteres que toCopy.

String(Char[])

Inicializa esta cadena para que contenga los valores especificados char.

String(Byte[])

Construye un nuevo String mediante la descodificación de la matriz especificada de bytes mediante el conjunto de caracteres predeterminado de la plataforma.

String(Byte[], Int32)
Obsoletos.

Asigna un nuevo String elemento que contiene caracteres construidos a partir de una matriz de valores enteros de 8 bits.

String(StringBuilder)

Asigna una nueva cadena que contiene la secuencia de caracteres que se encuentra actualmente en el argumento del generador de cadenas.

String(StringBuffer)

Asigna una nueva cadena que contiene la secuencia de caracteres que se encuentra actualmente en el argumento de búfer de cadena.

String()

Crea una cadena vacía.

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

Comentarios

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Se aplica a

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

Construye un nuevo String descodificar la subbarray especificada de bytes mediante el 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[]

Bytes que se van a descodificar en caracteres

offset
Int32

Índice del primer byte que se va a descodificar

length
Int32

Número de bytes que se van a descodificar

charsetName
String

Nombre de un conjunto de caracteres java.nio.charset.Charset admitido.

Atributos

Excepciones

si data == null.

si byteCount data.length.

si no se admite el conjunto de caracteres con nombre.

Comentarios

Documentación de Java para java.lang.String.String(byte[], int, int, java.lang.String).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Se aplica a

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

Precaución

deprecated

Asigna un nuevo String construido a partir de una subbarray de una matriz de valores enteros 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[]

Bytes que se van a convertir en caracteres

hibyte
Int32

Los 8 bits principales de cada unidad de código Unicode de 16 bits

offset
Int32

Desplazamiento inicial

count
Int32

Longitud

Atributos

Excepciones

si data == null.

si byteCount data.length

Comentarios

Asigna un nuevo String construido a partir de una subbarray de una matriz de valores enteros de 8 bits.

El offset argumento es el índice del primer byte de la subbarray y el count argumento especifica la longitud de la subbarray.

Cada byte una de las subbarray se convierte en como char se especifica en el #String(byte[],int) String(byte[],int) constructor.

Este miembro está en desuso. Este método no convierte correctamente bytes en caracteres. A partir de JDK  1.1, la manera preferida de hacerlo es a través de los String constructores que toman un java.nio.charset.Charset, nombre de conjunto de caracteres o que usan el conjunto de caracteres predeterminado de la plataforma.

Documentación de Java para java.lang.String.String(.*byte[], .*int, .*int, .*int).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Se aplica a

String(Int32[], Int32, Int32)

Asigna un nuevo String que contiene caracteres de una subbarray del argumento de matriz de puntos 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 es el origen de puntos de código Unicode

offset
Int32

Desplazamiento inicial

count
Int32

Longitud

Atributos

Excepciones

si codePoints == null.

si alguno de los elementos de no son puntos de codePoints código Unicode válidos.

si offset o count no están dentro de los límites de codePoints.

Comentarios

Asigna un nuevo String que contiene caracteres de una subbarray del argumento de matriz de puntos de código Unicode. El offset argumento es el índice del primer punto de código de la subbarray y el count argumento especifica la longitud de la subbarray. El contenido de la subbarray se convierte en chars; la modificación posterior de la int matriz no afecta a la cadena recién creada.

Agregado en 1.5.

Documentación de Java para java.lang.String.String(.*int[], .*int, .*int).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Se aplica a

String(Char[], Int32, Int32)

Inicializa esta cadena para que contenga los valores 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[]

Matriz de caracteres usada para inicializar la cadena.

offset
Int32

Desplazamiento en el que se realiza la operación.

charCount
Int32

Número de caracteres que se van a usar desde la matriz.

Atributos

Excepciones

si data == null.

si charCount data.length

Comentarios

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Se aplica a

String(Byte[], Int32, Int32)

Construye un nuevo String mediante la descodificación del subbarray especificado de bytes mediante el conjunto de caracteres predeterminado de la 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[]

Bytes que se van a descodificar en caracteres

offset
Int32

Índice del primer byte que se va a descodificar

length
Int32

Número de bytes que se van a descodificar

Atributos

Excepciones

si data == null.

si byteCount data.length.

Comentarios

Construye un nuevo String mediante la descodificación del subbarray especificado de bytes mediante el conjunto de caracteres predeterminado de la plataforma. La longitud del nuevo String es una función del conjunto de caracteres y, por tanto, puede no ser igual a la longitud de la subbarray.

El comportamiento de este constructor cuando los bytes especificados no son válidos en el conjunto de caracteres predeterminado no se especifica. La java.nio.charset.CharsetDecoder clase debe usarse cuando se requiere más control sobre el proceso de descodificación.

Agregado en la versión 1.1.

Documentación de Java para java.lang.String.String(.*byte[], .*int, .*int).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Se aplica a

String(Byte[], String)

Construye un nuevo String mediante la descodificación de la matriz especificada de bytes mediante el 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[]

Bytes que se van a descodificar en caracteres

charsetName
String

Nombre de un conjunto de caracteres java.nio.charset.Charset admitido.

Atributos

Excepciones

si data == null.

si charsetName no se admite.

Comentarios

Construye un nuevo String descodificación de la matriz especificada de bytes mediante el conjunto de caracteres java.nio.charset.Charset especificado. La longitud del nuevo String es una función del conjunto de caracteres y, por tanto, puede no ser igual a la longitud de la matriz de bytes.

El comportamiento de este constructor cuando los bytes especificados no son válidos en el conjunto de caracteres especificado no está especificado. La java.nio.charset.CharsetDecoder clase debe usarse cuando se requiere más control sobre el proceso de descodificación.

Agregado en la versión 1.1.

Documentación de Java para java.lang.String.String(byte[], java.lang.String).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Se aplica a

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

Construye un nuevo String mediante la descodificación de la subbarra especificada de bytes mediante el 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[]

Bytes que se van a descodificar en caracteres

offset
Int32

Índice del primer byte que se va a descodificar

length
Int32

Número de bytes que se van a descodificar

charset
Charset

El conjunto de caracteres java.nio.charset.Charset que se va a usar para descodificar el objeto bytes

Atributos

Excepciones

si byteCount data.length

si data == null

Comentarios

Construye un nuevo String mediante la descodificación del subbarray especificado de bytes mediante el conjunto de caracteres java.nio.charset.Charset especificado. La longitud del nuevo String es una función del conjunto de caracteres y, por tanto, puede no ser igual a la longitud de la subbarray.

Este método siempre reemplaza las secuencias de entrada y caracteres no válidos por la cadena de reemplazo predeterminada de este conjunto de caracteres. La java.nio.charset.CharsetDecoder clase debe usarse cuando se requiere más control sobre el proceso de descodificación.

Agregado en la versión 1.6.

Documentación de Java para java.lang.String.String(byte[], int, int, java.nio.charset.Charset).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Se aplica a

String(Byte[], Charset)

Construye un nuevo String mediante la descodificación de la matriz especificada de bytes mediante el 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[]

Bytes que se van a descodificar en caracteres

charset
Charset

El conjunto de caracteres java.nio.charset.Charset que se va a usar para descodificar el objeto bytes

Atributos

Excepciones

si data == null

Comentarios

Construye un nuevo String descodificación de la matriz especificada de bytes mediante el conjunto de caracteres java.nio.charset.Charset especificado. La longitud del nuevo String es una función del conjunto de caracteres y, por tanto, puede no ser igual a la longitud de la matriz de bytes.

Este método siempre reemplaza las secuencias de entrada y caracteres no válidos por la cadena de reemplazo predeterminada de este conjunto de caracteres. La java.nio.charset.CharsetDecoder clase debe usarse cuando se requiere más control sobre el proceso de descodificación.

Agregado en la versión 1.6.

Documentación de Java para java.lang.String.String(byte[], java.nio.charset.Charset).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Se aplica a

String(String)

Construye una nueva cadena con la misma secuencia de caracteres 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

Parámetros

toCopy
String

Cadena cuyos caracteres inicializan la nueva cadena.

Atributos

Comentarios

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Se aplica a

String(Char[])

Inicializa esta cadena para que contenga los valores 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[]

Matriz de caracteres usada para inicializar la cadena.

Atributos

Excepciones

si data == null

Comentarios

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Se aplica a

String(Byte[])

Construye un nuevo String mediante la descodificación de la matriz especificada de bytes mediante el conjunto de caracteres predeterminado de la 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[]

Bytes que se van a descodificar en caracteres

Atributos

Comentarios

Construye un nuevo String mediante la descodificación de la matriz especificada de bytes mediante el conjunto de caracteres predeterminado de la plataforma. La longitud del nuevo String es una función del conjunto de caracteres y, por tanto, puede no ser igual a la longitud de la matriz de bytes.

El comportamiento de este constructor cuando los bytes especificados no son válidos en el conjunto de caracteres predeterminado no se especifica. La java.nio.charset.CharsetDecoder clase debe usarse cuando se requiere más control sobre el proceso de descodificación.

Agregado en la versión 1.1.

Documentación de Java para java.lang.String.String(.*byte[]).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Se aplica a

String(Byte[], Int32)

Precaución

deprecated

Asigna un nuevo String elemento que contiene caracteres construidos a partir de una matriz de valores enteros 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[]

Bytes que se van a convertir en caracteres

hibyte
Int32

Los 8 bits principales de cada unidad de código Unicode de 16 bits

Atributos

Excepciones

si data == null.

Comentarios

Asigna un nuevo String elemento que contiene caracteres construidos a partir de una matriz de valores enteros de 8 bits. Cada carácter c de la cadena resultante se construye a partir del componente correspondiente b de la matriz de bytes de forma que:

<blockquote>

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

</blockquote>

Este miembro está en desuso. Este método no convierte correctamente bytes en caracteres. A partir de JDK  1.1, la manera preferida de hacerlo es a través de los String constructores que toman un java.nio.charset.Charset, nombre de conjunto de caracteres o que usan el conjunto de caracteres predeterminado de la plataforma.

Documentación de Java para java.lang.String.String(.*byte[], .*int).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Se aplica a

String(StringBuilder)

Asigna una nueva cadena que contiene la secuencia de caracteres que se encuentra actualmente en el argumento del generador de cadenas.

[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

Una operación StringBuilder

Atributos

Excepciones

si stringBuilder == null.

Comentarios

Asigna una nueva cadena que contiene la secuencia de caracteres que se encuentra actualmente en el argumento del generador de cadenas. El contenido del generador de cadenas se copia; La modificación posterior del generador de cadenas no afecta a la cadena recién creada.

Este constructor se proporciona para facilitar la migración a StringBuilder. Es probable que la obtención de una cadena de un generador de cadenas a través del toString método se ejecute más rápido y, por lo general, se prefiere.

Agregado en 1.5.

Documentación de Java para java.lang.String.String(java.lang.StringBuilder).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Se aplica a

String(StringBuffer)

Asigna una nueva cadena que contiene la secuencia de caracteres que se encuentra actualmente en el argumento de búfer de cadena.

[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

Una operación StringBuffer

Atributos

Comentarios

Asigna una nueva cadena que contiene la secuencia de caracteres que se encuentra actualmente en el argumento de búfer de cadena. El contenido del búfer de cadenas se copia; La modificación posterior del búfer de cadenas no afecta a la cadena recién creada.

Documentación de Java para java.lang.String.String(java.lang.StringBuffer).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Se aplica a