UTF8Encoding.GetChars Methode

Quelle:

UTF8Encoding.cs

Quelle:

UTF8Encoding.cs

Quelle:

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

Parameter

Gibt zurück

Die tatsächliche Anzahl der Zeichen, die in chars geschrieben werden.

Hinweise

Um die genaue Größe zu berechnen, die zum GetChars Speichern der resultierenden Zeichen erforderlich ist, rufen Sie die -Methode auf GetCharCount . Um die maximale Größe zu berechnen, rufen Sie die -Methode auf GetMaxCharCount . Die GetCharCount Methode weist in der Regel weniger Arbeitsspeicher zu, während die GetMaxCharCount Methode im Allgemeinen schneller ausgeführt wird.

Bei der Fehlererkennung bewirkt eine ungültige Sequenz, dass diese Methode eine ArgumentException Ausnahme auslöst. Ohne Fehlererkennung werden ungültige Sequenzen ignoriert, und es wird keine Ausnahme ausgelöst.

Wenn der Satz der zu decodierten Bytes die Bytereihenfolgemarkierung (BOM) enthält und die Bytespanne von einer Methode eines nicht BOM-fähigen Typs zurückgegeben wurde, wird das Zeichen U+FFFE in die Von dieser Methode zurückgegebene Spanne der Zeichen eingeschlossen. Sie können sie entfernen, indem Sie die String.TrimStart -Methode aufrufen.

Zu konvertierende Daten, z. B. Daten, die aus einem Stream gelesen werden, sind möglicherweise nur in sequenziellen Blöcken verfügbar. Und in diesem Fall, wenn die Menge der Daten so umfangreich ist, dass er in kleinere Blöcke aufgeteilt werden muss, verwenden die Decoder oder Encoder Objekt bereitgestellt werden, indem Sie die GetDecoder Methode oder die GetEncoder -Methode, bzw.

Quelle:

UTF8Encoding.cs

Quelle:

UTF8Encoding.cs

Quelle:

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

Parameter

Gibt zurück

Die durch chars angegebene tatsächliche Anzahl der Zeichen, die am Speicherort geschrieben wurden.

Attribute

CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Ausnahmen

Hinweise

Um die genaue Arraygröße zu berechnen, die für GetChars das Speichern der resultierenden Zeichen erforderlich ist, rufen Sie die -Methode auf GetCharCount . Um die maximale Array Größe zu berechnen, müssen Sie die-Methode aufzurufen GetMaxCharCount . Die GetCharCount Methode weist in der Regel weniger Arbeitsspeicher zu, während die GetMaxCharCount Methode im Allgemeinen schneller ausgeführt wird.

Bei der Fehlererkennung bewirkt eine ungültige Sequenz, dass diese Methode eine ArgumentException Ausnahme auslöst. Ohne Fehlererkennung werden ungültige Sequenzen ignoriert, und es wird keine Ausnahme ausgelöst.

Wenn der Bereich der zu decodierenden Bytes die Bytereihenfolgemarkierung (BOM) umfasst und das Bytearray von einer Methode eines nicht BOM-fähigen Typs zurückgegeben wurde, wird das Zeichen U+FFFE in das von dieser Methode zurückgegebene Zeichenarray eingeschlossen. Sie können sie entfernen, indem Sie die String.TrimStart -Methode aufrufen.

Zu konvertierende Daten, z. B. Daten, die aus einem Stream gelesen werden, sind möglicherweise nur in sequenziellen Blöcken verfügbar. Und in diesem Fall, wenn die Menge der Daten so umfangreich ist, dass er in kleinere Blöcke aufgeteilt werden muss, verwenden die Decoder oder Encoder Objekt bereitgestellt werden, indem Sie die GetDecoder Methode oder die GetEncoder -Methode, bzw.

Weitere Informationen

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

Quelle:

UTF8Encoding.cs

Quelle:

UTF8Encoding.cs

Quelle:

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

Parameter

Gibt zurück

Die tatsächliche Anzahl der Zeichen, die in chars geschrieben werden.

Ausnahmen

Beispiele

Im folgenden Beispiel wird die GetChars -Methode verwendet, um einen Bereich von Elementen in einem Bytearray zu decodieren und das Ergebnis in einem Zeichenarray zu speichern.

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

Hinweise

Um die genaue Arraygröße zu berechnen, die für GetChars das Speichern der resultierenden Zeichen erforderlich ist, rufen Sie die -Methode auf GetCharCount . Um die maximale Array Größe zu berechnen, müssen Sie die-Methode aufzurufen GetMaxCharCount . Die GetCharCount Methode weist in der Regel weniger Arbeitsspeicher zu, während die GetMaxCharCount Methode im Allgemeinen schneller ausgeführt wird.

Bei der Fehlererkennung bewirkt eine ungültige Sequenz, dass diese Methode eine ArgumentException Ausnahme auslöst. Ohne Fehlererkennung werden ungültige Sequenzen ignoriert, und es wird keine Ausnahme ausgelöst.

Wenn der Bereich der zu decodierenden Bytes die Bytereihenfolgemarkierung (BOM) umfasst und das Bytearray von einer Methode eines nicht BOM-fähigen Typs zurückgegeben wurde, wird das Zeichen U+FFFE in das von dieser Methode zurückgegebene Zeichenarray eingeschlossen. Sie können sie entfernen, indem Sie die String.TrimStart -Methode aufrufen.

Zu konvertierende Daten, z. B. Daten, die aus einem Stream gelesen werden, sind möglicherweise nur in sequenziellen Blöcken verfügbar. In diesem Fall, oder wenn die Menge der Daten so umfangreich ist, dass er in kleinere Blöcke aufgeteilt werden muss, verwenden die Decoder oder die Encoder gebotenen der GetDecoder Methode oder die GetEncoder -Methode, bzw.

Weitere Informationen

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