UTF8Encoding.GetChars Metodo

Origine:

UTF8Encoding.cs

Origine:

UTF8Encoding.cs

Origine:

UTF8Encoding.cs

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

Restituisce

Numero effettivo di caratteri scritti in chars.

Commenti

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

Con il rilevamento degli errori, una sequenza non valida causa la generazione di un'eccezione ArgumentException da parte di 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 contrassegno dell'ordine dei byte (BOM) e l'intervallo di byte è stato restituito da un metodo di un tipo non compatibile con BOM, il carattere U+FFFE viene incluso nell'intervallo di caratteri restituiti 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 divisa in blocchi più piccoli, usare rispettivamente l'oggetto DecoderEncoder o fornito dal GetDecoder metodo o dal GetEncoder metodo .

Origine:

UTF8Encoding.cs

Origine:

UTF8Encoding.cs

Origine:

UTF8Encoding.cs

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

Restituisce

Numero effettivo di caratteri scritti nella posizione indicata da chars.

Attributi

CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Eccezioni

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. Il GetCharCount metodo in genere alloca meno memoria, mentre il GetMaxCharCount metodo viene in genere eseguito più velocemente.

Con il rilevamento degli errori, una sequenza non valida causa la generazione di un'eccezione ArgumentException da parte di 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 contrassegno dell'ordine dei byte (BOM) e la matrice di byte è stata restituita da un metodo di un tipo non compatibile con 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 divisa in blocchi più piccoli, usare rispettivamente l'oggetto DecoderEncoder o fornito dal GetDecoder metodo o dal GetEncoder metodo .

Vedi anche

• GetCharCount(Byte[], Int32, Int32)
• GetMaxCharCount(Int32)
• GetDecoder()
• GetString(Byte[], Int32, Int32)

Origine:

UTF8Encoding.cs

Origine:

UTF8Encoding.cs

Origine:

UTF8Encoding.cs

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

Restituisce

Numero effettivo di caratteri scritti in chars.

Eccezioni

Esempio

Nell'esempio seguente viene usato il GetChars metodo per decodificare un intervallo di elementi in una matrice di byte e 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. Il GetCharCount metodo in genere alloca meno memoria, mentre il GetMaxCharCount metodo viene in genere eseguito più velocemente.

Con il rilevamento degli errori, una sequenza non valida causa la generazione di un'eccezione ArgumentException da parte di 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 contrassegno dell'ordine dei byte (BOM) e la matrice di byte è stata restituita da un metodo di un tipo non compatibile con 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 divisa in blocchi più piccoli, usare rispettivamente l'oggetto DecoderEncoder o fornito dal GetDecoder metodo o dal GetEncoder metodo .

Vedi anche

• GetCharCount(Byte[], Int32, Int32)
• GetMaxCharCount(Int32)
• GetDecoder()
• GetString(Byte[], Int32, Int32)