String Constructores
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| Nombre | Description |
|---|---|
| String() |
Crea una cadena vacía. |
| String(Byte[], Int32, Int32, String) |
Construye un nuevo |
| String(Byte[], Int32, Int32, Int32) |
Obsoletos.
Asigna un nuevo |
| String(Int32[], Int32, Int32) |
Asigna un nuevo |
| String(Char[], Int32, Int32) |
Inicializa esta cadena para que contenga los valores especificados |
| String(Byte[], Int32, Int32) |
Construye un nuevo |
| String(Byte[], String) |
Construye un nuevo |
| String(Byte[], Int32, Int32, Charset) |
Construye un nuevo |
| String(Byte[], Charset) |
Construye un nuevo |
| String(String) |
Construye una nueva cadena con la misma secuencia de caracteres que |
| String(Char[]) |
Inicializa esta cadena para que contenga los valores especificados |
| String(Byte[]) |
Construye un nuevo |
| String(Byte[], Int32) |
Obsoletos.
Asigna un nuevo |
| 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 & 0xff) << 8)
| (<b><i>b</i></b> & 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.