UTF8Encoding.GetChars Metodo

Definizione

Decodifica una sequenza di byte in un set di caratteri.

Overload

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

Decodifica l'intervallo di byte specificato nell'intervallo di caratteri specificato.

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

Decodifica una sequenza di byte a partire dal puntatore ai byte specificato in un set di caratteri archiviati a partire dal puntatore ai caratteri specificato.

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

Decodifica una sequenza di byte dalla matrice di byte specificata nella matrice di caratteri specificata.

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

Decodifica l'intervallo di byte specificato nell'intervallo di caratteri specificato.

public:
 override int GetChars(ReadOnlySpan<System::Byte> bytes, Span<char> chars);
public override int GetChars (ReadOnlySpan<byte> bytes, Span<char> chars);
override this.GetChars : ReadOnlySpan<byte> * Span<char> -> int
Public Overrides Function GetChars (bytes As ReadOnlySpan(Of Byte), chars As Span(Of Char)) As Integer

Parametri

bytes
ReadOnlySpan<Byte>

Intervallo contenente i byte da decodificare.

chars
Span<Char>

Intervallo che conterrà il set di caratteri risultante.

Restituisce

Int32

Numero effettivo di caratteri scritti in chars.

Commenti

Per calcolare le dimensioni esatte richieste da GetChars per archiviare i caratteri risultanti, chiamare il GetCharCount metodo . Per calcolare le dimensioni massime, chiamare il GetMaxCharCount metodo . In GetCharCount genere, il metodo alloca meno memoria, mentre il GetMaxCharCount metodo in genere viene eseguito più velocemente.

Con il rilevamento degli errori, una sequenza non valida causa la generazione di un'eccezione da parte di ArgumentException questo metodo. Senza il rilevamento degli errori, le sequenze non valide vengono ignorate e non viene generata alcuna eccezione.

Se il set di byte da decodificare include il byte order mark (BOM) e l'intervallo di byte è stato restituito da un metodo di tipo non BOM, il carattere viene incluso nell'intervallo di caratteri restituito da U+FFFE questo metodo. È possibile rimuoverlo chiamando il String.TrimStart metodo .

I dati da convertire, ad esempio i dati letti da un flusso, potrebbero essere disponibili solo in blocchi sequenziali. In questo caso, o se la quantità di dati è così grande che deve essere suddivisa in blocchi più piccoli, usare rispettivamente l'oggetto o fornito dal metodo o Decoder Encoder dal metodo GetDecoder GetEncoder .

Si applica a

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

Importante

Questa API non è conforme a CLS.

Decodifica una sequenza di byte a partire dal puntatore ai byte specificato in un set di caratteri archiviati a partire dal puntatore ai caratteri specificato.

public:
 override int GetChars(System::Byte* bytes, int byteCount, char* chars, int charCount);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public override int GetChars (byte* bytes, int byteCount, char* chars, int charCount);
[System.CLSCompliant(false)]
public override int GetChars (byte* bytes, int byteCount, char* chars, int charCount);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetChars (byte* bytes, int byteCount, char* chars, int charCount);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetChars (byte* bytes, int byteCount, char* chars, int charCount);
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int -> int
[<System.CLSCompliant(false)>]
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int -> int
[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int -> int
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int -> int

Parametri

bytes
Byte*

Puntatore al primo byte da decodificare.

byteCount
Int32

Numero di byte da decodificare.

chars
Char*

Puntatore alla posizione in cui iniziare a scrivere il set di caratteri risultante.

charCount
Int32

Numero massimo di caratteri da scrivere.

Restituisce

Int32

Numero effettivo di caratteri scritti nella posizione indicata da chars.

Attributi

Eccezioni

bytes è null.

-oppure- chars è null.

byteCount o charCount è minore di zero.

Il rilevamento degli errori è abilitato, e bytes contiene una sequenza di byte non valida.

-oppure- charCount è minore del numero di caratteri risultante.

Si è verificato un fallback (per altre informazioni, vedere Codifica dei caratteri in .NET) -e- DecoderFallback è impostato su DecoderExceptionFallback.

Commenti

Per calcolare la dimensione esatta della matrice richiesta da GetChars per archiviare i caratteri risultanti, chiamare il GetCharCount metodo . Per calcolare la dimensione massima della matrice, chiamare il GetMaxCharCount metodo. In GetCharCount genere, il metodo alloca meno memoria, mentre il GetMaxCharCount metodo in genere viene eseguito più velocemente.

Con il rilevamento degli errori, una sequenza non valida causa la generazione di un'eccezione da parte di ArgumentException questo metodo. Senza il rilevamento degli errori, le sequenze non valide vengono ignorate e non viene generata alcuna eccezione.

Se l'intervallo di byte da decodificare include il carattere byte order mark (BOM) e la matrice di byte è stata restituita da un metodo di tipo non BOM, il carattere U+FFFE viene incluso nella matrice di caratteri restituita da questo metodo. È possibile rimuoverlo chiamando il String.TrimStart metodo .

I dati da convertire, ad esempio i dati letti da un flusso, potrebbero essere disponibili solo in blocchi sequenziali. In questo caso, o se la quantità di dati è così grande che deve essere suddivisa in blocchi più piccoli, usare rispettivamente l'oggetto o fornito dal metodo o Decoder Encoder dal metodo GetDecoder GetEncoder .

Vedi anche

Si applica a

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

Decodifica una sequenza di byte dalla matrice di byte specificata nella matrice di caratteri specificata.

public:
 override int GetChars(cli::array <System::Byte> ^ bytes, int byteIndex, int byteCount, cli::array <char> ^ chars, int charIndex);
public override int GetChars (byte[] bytes, int byteIndex, int byteCount, char[] chars, int charIndex);
override this.GetChars : byte[] * int * int * char[] * int -> int
Public Overrides Function GetChars (bytes As Byte(), byteIndex As Integer, byteCount As Integer, chars As Char(), charIndex As Integer) As Integer

Parametri

bytes
Byte[]

Matrice di byte contenente la sequenza di byte da decodificare.

byteIndex
Int32

Indice del primo byte da decodificare.

byteCount
Int32

Numero di byte da decodificare.

chars
Char[]

Matrice di caratteri che deve contenere il set di caratteri risultante.

charIndex
Int32

Indice in corrispondenza del quale iniziare a scrivere il set di caratteri risultante.

Restituisce

Int32

Numero effettivo di caratteri scritti in chars.

Eccezioni

bytes è null.

-oppure- chars è null.

byteIndex o byteCount o charIndex è minore di zero.

-oppure- byteindex e byteCount non identificano un intervallo valido in bytes.

-oppure- charIndex non è un indice valido in chars.

Il rilevamento degli errori è abilitato, e bytes contiene una sequenza di byte non valida.

-oppure- chars non dispone di sufficiente capacità da charIndex alla fine della matrice per contenere i caratteri risultanti.

Si è verificato un fallback (per altre informazioni, vedere Codifica dei caratteri in .NET) -e- DecoderFallback è impostato su DecoderExceptionFallback.

Esempio

Nell'esempio seguente viene utilizzato il metodo per decodificare un intervallo di elementi in una matrice di byte e GetChars archiviare il risultato in una matrice di caratteri.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Char>^chars;
   array<Byte>^bytes = {85,84,70,56,32,69,110,99,111,100,105,110,103,32,69,120,97,109,112,108,101};
   UTF8Encoding^ utf8 = gcnew UTF8Encoding;
   int charCount = utf8->GetCharCount( bytes, 2, 13 );
   chars = gcnew array<Char>(charCount);
   int charsDecodedCount = utf8->GetChars( bytes, 2, 13, 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();
}
using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main() {
        Char[] chars;
        Byte[] bytes = new Byte[] {
             85,  84,  70,  56,  32,  69, 110,
             99, 111, 100, 105, 110, 103,  32,
             69, 120,  97, 109, 112, 108, 101
        };

        UTF8Encoding utf8 = new UTF8Encoding();

        int charCount = utf8.GetCharCount(bytes, 2, 13);
        chars = new Char[charCount];
        int charsDecodedCount = utf8.GetChars(bytes, 2, 13, 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();
    }
}
Imports System.Text

Class UTF8EncodingExample
    
    Public Shared Sub Main()
        Dim chars() As Char
        Dim bytes() As Byte = { _
            85,  84,  70,  56,  32,  69, 110, _
            99, 111, 100, 105, 110, 103,  32, _
            69, 120,  97, 109, 112, 108, 101 _
        }
        
        Dim utf8 As New UTF8Encoding()
        
        Dim charCount As Integer = utf8.GetCharCount(bytes, 2, 13)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = utf8.GetChars(bytes, 2, 13, 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

Commenti

Per calcolare la dimensione esatta della matrice richiesta da GetChars per archiviare i caratteri risultanti, chiamare il GetCharCount metodo . Per calcolare la dimensione massima della matrice, chiamare il GetMaxCharCount metodo. In GetCharCount genere, il metodo alloca meno memoria, mentre il GetMaxCharCount metodo in genere viene eseguito più velocemente.

Con il rilevamento degli errori, una sequenza non valida causa la generazione di un'eccezione da parte di ArgumentException questo metodo. Senza il rilevamento degli errori, le sequenze non valide vengono ignorate e non viene generata alcuna eccezione.

Se l'intervallo di byte da decodificare include il carattere byte order mark (BOM) e la matrice di byte è stata restituita da un metodo di tipo non BOM, il carattere U+FFFE viene incluso nella matrice di caratteri restituita da questo metodo. È possibile rimuoverlo chiamando il String.TrimStart metodo .

I dati da convertire, ad esempio i dati letti da un flusso, potrebbero essere disponibili solo in blocchi sequenziali. In questo caso, o se la quantità di dati è così grande che deve essere suddivisa in blocchi più piccoli, usare rispettivamente o fornito dal metodo o Decoder Encoder dal metodo GetDecoder GetEncoder .

Vedi anche

Si applica a