Decoder.GetChars Método

Definición

Espacio de nombres:

System.Text

Ensamblado:

System.Runtime.dll

Cuando se invalida en una clase derivada, descodifica una secuencia de bytes en un conjunto de caracteres.

Sobrecargas

GetChars(ReadOnlySpan<Byte>, Span<Char>, Boolean)	Cuando se reemplaza en una clase derivada, descodifica una secuencia de bytes de intervalo y cualquier bytes del búfer interno en un conjunto de caracteres que se almacenan a partir del puntero de caracteres especificado. Un parámetro indica si se borra el estado interno del descodificador después de la conversión.
GetChars(Byte*, Int32, Char*, Int32, Boolean)	Cuando se reemplaza en una clase derivada, descodifica una secuencia de bytes a partir del puntero de bytes especificado y cualquier bytes del búfer interno en un conjunto de caracteres que se almacenan a partir del puntero de caracteres especificado. Un parámetro indica si se borra el estado interno del descodificador después de la conversión.
GetChars(Byte[], Int32, Int32, Char[], Int32)	Cuando se reemplaza en una clase derivada, descodifica una secuencia de bytes de la matriz de bytes especificada y cualquier bytes del búfer interno en la matriz de caracteres especificada.
GetChars(Byte[], Int32, Int32, Char[], Int32, Boolean)	Cuando se reemplaza en una clase derivada, descodifica una secuencia de bytes de la matriz de bytes especificada y cualquier bytes del búfer interno en la matriz de caracteres especificada. Un parámetro indica si se borra el estado interno del descodificador después de la conversión.

GetChars(ReadOnlySpan<Byte>, Span<Char>, Boolean)

Source:

Decoder.cs

Cuando se reemplaza en una clase derivada, descodifica una secuencia de bytes de intervalo y cualquier bytes del búfer interno en un conjunto de caracteres que se almacenan a partir del puntero de caracteres especificado. Un parámetro indica si se borra el estado interno del descodificador después de la conversión.

public:
 virtual int GetChars(ReadOnlySpan<System::Byte> bytes, Span<char> chars, bool flush);

public virtual int GetChars (ReadOnlySpan<byte> bytes, Span<char> chars, bool flush);

abstract member GetChars : ReadOnlySpan<byte> * Span<char> * bool -> int
override this.GetChars : ReadOnlySpan<byte> * Span<char> * bool -> int

Public Overridable Function GetChars (bytes As ReadOnlySpan(Of Byte), chars As Span(Of Char), flush As Boolean) As Integer

Parámetros

bytes

ReadOnlySpan<Byte>

Intervalo de bytes que se va a descodificar.

chars

Span<Char>

Intervalo para escribir el conjunto de caracteres resultante.

flush

Boolean

true borrar el estado interno del descodificador después de la conversión; de lo contrario, false.

Devoluciones

Int32

Número real de caracteres escritos en el intervalo indicado por el parámetro chars.

Comentarios

Recuerde que el objeto Decoder guarda el estado entre las llamadas a GetChars. Cuando la aplicación se realiza con un flujo de datos, debe establecer el parámetro flush en true para asegurarse de que la información de estado está vacía. Con esta configuración, el descodificador omite bytes no válidos al final del bloque de datos y borra el búfer interno.

Para calcular el tamaño exacto del intervalo que GetChars requiere almacenar los caracteres resultantes, la aplicación debe usar GetCharCount.

Si se llama a GetChars con flush establecido en false, el descodificador almacena los bytes finales al final del bloque de datos en un búfer interno y los usa en la siguiente operación de descodificación. La aplicación debe llamar a GetCharCount en un bloque de datos inmediatamente antes de llamar a GetChars en el mismo bloque, de modo que los bytes finales del bloque anterior se incluyan en el cálculo.

Si la aplicación va a convertir muchos segmentos de un flujo de entrada, considere la posibilidad de usar el método Convert. GetChars producirá una excepción si el intervalo de salida no es lo suficientemente grande, pero Convert rellenará tanto espacio como sea posible y devolverá los bytes leídos y caracteres escritos, siempre que la matriz de salida permita al menos dos caracteres. Consulte también el tema Encoding.GetChars para obtener más comentarios.

GetChars(Byte*, Int32, Char*, Int32, Boolean)

Source:

Decoder.cs

Importante

Esta API no es conforme a CLS.

Cuando se reemplaza en una clase derivada, descodifica una secuencia de bytes a partir del puntero de bytes especificado y cualquier bytes del búfer interno en un conjunto de caracteres que se almacenan a partir del puntero de caracteres especificado. Un parámetro indica si se borra el estado interno del descodificador después de la conversión.

public:
 virtual int GetChars(System::Byte* bytes, int byteCount, char* chars, int charCount, bool flush);

[System.CLSCompliant(false)]
public virtual int GetChars (byte* bytes, int byteCount, char* chars, int charCount, bool flush);

[<System.CLSCompliant(false)>]
abstract member GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int

Parámetros

bytes

Byte*

Puntero al primer byte que se va a descodificar.

byteCount

Int32

Número de bytes que se van a descodificar.

chars

Char*

Puntero a la ubicación en la que se empieza a escribir el conjunto de caracteres resultante.

charCount

Int32

Número máximo de caracteres que se van a escribir.

flush

Boolean

true borrar el estado interno del descodificador después de la conversión; de lo contrario, false.

Devoluciones

Int32

Número real de caracteres escritos en la ubicación indicada por el parámetro chars.

Atributos

CLSCompliantAttribute

Excepciones

ArgumentNullException

bytes es null (Nothing).

-o-

chars es null (Nothing).

ArgumentOutOfRangeException

byteCount o charCount es menor que cero.

ArgumentException

charCount es menor que el número resultante de caracteres.

DecoderFallbackException

Se produjo una reserva (para obtener más información, vea codificación de caracteres en .NET)

-y-

Fallback se establece en DecoderExceptionFallback.

Comentarios

Recuerde que el objeto Decoder guarda el estado entre las llamadas a GetChars. Cuando la aplicación se realiza con un flujo de datos, debe establecer el parámetro flush en true para asegurarse de que la información de estado está vacía. Con esta configuración, el descodificador omite bytes no válidos al final del bloque de datos y borra el búfer interno.

Para calcular el tamaño exacto del búfer que GetChars requiere almacenar los caracteres resultantes, la aplicación debe usar GetCharCount.

Si se llama a GetChars con flush establecido en false, el descodificador almacena los bytes finales al final del bloque de datos en un búfer interno y los usa en la siguiente operación de descodificación. La aplicación debe llamar a GetCharCount en un bloque de datos inmediatamente antes de llamar a GetChars en el mismo bloque, de modo que los bytes finales del bloque anterior se incluyan en el cálculo.

Si la aplicación va a convertir muchos segmentos de un flujo de entrada, considere la posibilidad de usar el método Convert. GetChars producirá una excepción si el búfer de salida no es lo suficientemente grande, pero Convert rellenará tanto espacio como sea posible y devolverá los bytes leídos y caracteres escritos, siempre que la matriz de salida permita al menos dos caracteres. Consulte también el tema Encoding.GetChars para obtener más comentarios.

Consulte también

• GetCharCount(Byte*, Int32, Boolean)
• Reset()

GetChars(Byte[], Int32, Int32, Char[], Int32)

Source:

Decoder.cs

Cuando se reemplaza en una clase derivada, descodifica una secuencia de bytes de la matriz de bytes especificada y cualquier bytes del búfer interno en la matriz de caracteres especificada.

public:
 abstract int GetChars(cli::array <System::Byte> ^ bytes, int byteIndex, int byteCount, cli::array <char> ^ chars, int charIndex);

public abstract int GetChars (byte[] bytes, int byteIndex, int byteCount, char[] chars, int charIndex);

abstract member GetChars : byte[] * int * int * char[] * int -> int

Public MustOverride Function GetChars (bytes As Byte(), byteIndex As Integer, byteCount As Integer, chars As Char(), charIndex As Integer) As Integer

Parámetros

bytes

Byte[]

Matriz de bytes que contiene la secuencia de bytes que se va a descodificar.

byteIndex

Int32

Índice del primer byte que se va a descodificar.

byteCount

Int32

Número de bytes que se van a descodificar.

chars

Char[]

Matriz de caracteres que va a contener el conjunto de caracteres resultante.

charIndex

Int32

Índice en el que se empieza a escribir el conjunto de caracteres resultante.

Devoluciones

Int32

Número real de caracteres escritos en chars.

Excepciones

ArgumentNullException

bytes es null (Nothing).

-o-

chars es null (Nothing).

ArgumentOutOfRangeException

byteIndex o byteCount o charIndex es menor que cero.

-o-

byteindex y byteCount no denotan un intervalo válido en bytes.

-o-

charIndex no es un índice válido en chars.

ArgumentException

chars no tiene suficiente capacidad de charIndex al final de la matriz para dar cabida a los caracteres resultantes.

DecoderFallbackException

Se produjo una reserva (para obtener más información, vea codificación de caracteres en .NET)

-y-

Fallback se establece en DecoderExceptionFallback.

Ejemplos

En el ejemplo siguiente se muestra cómo descodificar un intervalo de elementos de una matriz de bytes y almacenarlos en una matriz de caracteres Unicode. El método GetCharCount se usa para calcular el número de caracteres necesarios para almacenar los elementos descodificados en la matriz bytes. El método GetChars descodifica los elementos especificados en la matriz de bytes y los almacena en la nueva matriz de caracteres.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Char>^chars;
   array<Byte>^bytes = {85,0,110,0,105,0,99,0,111,0,100,0,101,0};
   Decoder^ uniDecoder = Encoding::Unicode->GetDecoder();
   int charCount = uniDecoder->GetCharCount( bytes, 0, bytes->Length );
   chars = gcnew array<Char>(charCount);
   int charsDecodedCount = uniDecoder->GetChars( bytes, 0, bytes->Length, chars, 0 );
   Console::WriteLine( "{0} characters used to decode bytes.", charsDecodedCount );
   Console::Write( "Decoded chars: " );
   IEnumerator^ myEnum = chars->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Char c = safe_cast<Char>(myEnum->Current);
      Console::Write( "[{0}]", c.ToString() );
   }

   Console::WriteLine();
}

/* This code example produces the following output.

7 characters used to decode bytes.
Decoded chars: [U][n][i][c][o][d][e]

*/

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        Char[] chars;
        Byte[] bytes = new Byte[] {
            85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0
        };

        Decoder uniDecoder = Encoding.Unicode.GetDecoder();

        int charCount = uniDecoder.GetCharCount(bytes, 0, bytes.Length);
        chars = new Char[charCount];
        int charsDecodedCount = uniDecoder.GetChars(bytes, 0, bytes.Length, chars, 0);

        Console.WriteLine(
            "{0} characters used to decode bytes.", charsDecodedCount
        );

        Console.Write("Decoded chars: ");
        foreach (Char c in chars) {
            Console.Write("[{0}]", c);
        }
        Console.WriteLine();
    }
}

/* This code example produces the following output.

7 characters used to decode bytes.
Decoded chars: [U][n][i][c][o][d][e]

*/

Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim chars() As Char
        Dim bytes() As Byte = { _
            85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0 _
        }
        
        Dim uniDecoder As Decoder = Encoding.Unicode.GetDecoder()
        
        Dim charCount As Integer = uniDecoder.GetCharCount(bytes, 0, bytes.Length)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = _
            uniDecoder.GetChars(bytes, 0, bytes.Length, chars, 0)
        
        Console.WriteLine( _
            "{0} characters used to decode bytes.", _
            charsDecodedCount _
        )
        
        Console.Write("Decoded chars: ")
        Dim c As Char
        For Each c In  chars
            Console.Write("[{0}]", c)
        Next c
        Console.WriteLine()
    End Sub
End Class

'This code example produces the following output.
'
'7 characters used to decode bytes.
'Decoded chars: [U][n][i][c][o][d][e]
'

Comentarios

Recuerde que el objeto Decoder guarda el estado entre las llamadas a GetChars. Cuando la aplicación se realiza con un flujo de datos, debe establecer el parámetro flush en true para asegurarse de que la información de estado está vacía. Con esta configuración, el descodificador omite bytes no válidos al final del bloque de datos y borra el búfer interno.

Para calcular el tamaño exacto de la matriz que GetChars requiere almacenar los caracteres resultantes, la aplicación debe usar GetCharCount.

Si se llama a GetChars con flush establecido en false, el descodificador almacena los bytes finales al final del bloque de datos en un búfer interno y los usa en la siguiente operación de descodificación. La aplicación debe llamar a GetCharCount en un bloque de datos inmediatamente antes de llamar a GetChars en el mismo bloque, de modo que los bytes finales del bloque anterior se incluyan en el cálculo.

Si la aplicación va a convertir muchos segmentos de un flujo de entrada, considere la posibilidad de usar el método Convert. GetChars producirá una excepción si el búfer de salida no es lo suficientemente grande, pero Convert rellenará tanto espacio como sea posible y devolverá los bytes leídos y caracteres escritos, siempre que la matriz de salida permita al menos dos caracteres. Consulte también el tema Encoding.GetChars para obtener más comentarios.

Consulte también

• GetCharCount(Byte[], Int32, Int32)
• Reset()

GetChars(Byte[], Int32, Int32, Char[], Int32, Boolean)

Source:

Decoder.cs

Cuando se reemplaza en una clase derivada, descodifica una secuencia de bytes de la matriz de bytes especificada y cualquier bytes del búfer interno en la matriz de caracteres especificada. Un parámetro indica si se borra el estado interno del descodificador después de la conversión.

public:
 virtual int GetChars(cli::array <System::Byte> ^ bytes, int byteIndex, int byteCount, cli::array <char> ^ chars, int charIndex, bool flush);

public virtual int GetChars (byte[] bytes, int byteIndex, int byteCount, char[] chars, int charIndex, bool flush);

abstract member GetChars : byte[] * int * int * char[] * int * bool -> int
override this.GetChars : byte[] * int * int * char[] * int * bool -> int

Public Overridable Function GetChars (bytes As Byte(), byteIndex As Integer, byteCount As Integer, chars As Char(), charIndex As Integer, flush As Boolean) As Integer

Parámetros

bytes

Byte[]

Matriz de bytes que contiene la secuencia de bytes que se va a descodificar.

byteIndex

Int32

Índice del primer byte que se va a descodificar.

byteCount

Int32

Número de bytes que se van a descodificar.

chars

Char[]

Matriz de caracteres que va a contener el conjunto de caracteres resultante.

charIndex

Int32

Índice en el que se empieza a escribir el conjunto de caracteres resultante.

flush

Boolean

true borrar el estado interno del descodificador después de la conversión; de lo contrario, false.

Devoluciones

Int32

Número real de caracteres escritos en el parámetro chars.

Excepciones

ArgumentNullException

bytes es null (Nothing).

-o-

chars es null (Nothing).

ArgumentOutOfRangeException

byteIndex o byteCount o charIndex es menor que cero.

-o-

byteindex y byteCount no denotan un intervalo válido en bytes.

-o-

charIndex no es un índice válido en chars.

ArgumentException

chars no tiene suficiente capacidad de charIndex al final de la matriz para dar cabida a los caracteres resultantes.

DecoderFallbackException

Se produjo una reserva (para obtener más información, vea codificación de caracteres en .NET)

-y-

Fallback se establece en DecoderExceptionFallback.

Comentarios

Recuerde que el objeto Decoder guarda el estado entre las llamadas a GetChars. Cuando la aplicación se realiza con un flujo de datos, debe establecer el parámetro flush en true para asegurarse de que la información de estado está vacía. Con esta configuración, el descodificador omite bytes no válidos al final del bloque de datos y borra el búfer interno.

Para calcular el tamaño exacto de la matriz que GetChars requiere almacenar los caracteres resultantes, la aplicación debe usar GetCharCount.

Si se llama a GetChars con flush establecido en false, el descodificador almacena los bytes finales al final del bloque de datos en un búfer interno y los usa en la siguiente operación de descodificación. La aplicación debe llamar a GetCharCount en un bloque de datos inmediatamente antes de llamar a GetChars en el mismo bloque, de modo que los bytes finales del bloque anterior se incluyan en el cálculo.

Si la aplicación va a convertir muchos segmentos de un flujo de entrada, considere la posibilidad de usar el método Convert. GetChars producirá una excepción si el búfer de salida no es lo suficientemente grande, pero Convert rellenará tanto espacio como sea posible y devolverá los bytes leídos y caracteres escritos, siempre que la matriz de salida permita al menos dos caracteres. Consulte también el tema Encoding.GetChars para obtener más comentarios.

Consulte también

• GetCharCount(Byte[], Int32, Int32, Boolean)
• Reset()