UTF8Encoding.GetChars Metoda

Definice

Obor názvů:

System.Text

Sestavení:

netstandard.dll, System.Text.Encoding.Extensions.dll

Dekóduje posloupnost bajtů do sady znaků.

Přetížení

Name	Description
GetChars(ReadOnlySpan<Byte>, Span<Char>)	Dekóduje zadané bajtové rozpětí do zadaného rozsahu znaků.
GetChars(Byte*, Int32, Char*, Int32)	Dekóduje posloupnost bajtů počínaje zadaným bajtovým ukazatelem na sadu znaků, které jsou uloženy od zadaného ukazatele znaků.
GetChars(Byte[], Int32, Int32, Char[], Int32)	Dekóduje posloupnost bajtů ze zadaného bajtového pole do zadaného znakového pole.

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

Zdroj:

UTF8Encoding.cs

Dekóduje zadané bajtové rozpětí do zadaného rozsahu znaků.

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

Parametry

bytes

ReadOnlySpan<Byte>

Rozsah obsahující bajty pro dekódování.

chars

Span<Char>

Rozsah obsahující výslednou sadu znaků.

Návraty

Int32

Skutečný počet znaků zapsaných do chars.

Poznámky

Pokud chcete vypočítat přesnou velikost potřebnou GetChars k uložení výsledných znaků, zavolejte metodu GetCharCount . Pokud chcete vypočítat maximální velikost, zavolejte metodu GetMaxCharCount . Metoda GetCharCount obecně přiděluje méně paměti, zatímco GetMaxCharCount metoda obvykle provádí rychleji.

Při detekci chyb způsobí neplatná posloupnost vyvolání výjimky touto metodou ArgumentException . Bez detekce chyb se ignorují neplatné sekvence a nevyvolá se žádná výjimka.

Pokud sada bajtů, které se mají dekódovat, zahrnuje značku pořadí bajtů (BOM) a rozsah bajtů byl vrácen metodou typu bez boM, je znak U+FFFE zahrnut do rozsahu znaků vrácených touto metodou. Můžete ho odebrat voláním String.TrimStart metody.

Data, která se mají převést, například čtení dat ze streamu, můžou být k dispozici pouze v sekvenčních blocích. V tomto případě nebo pokud je množství dat tak velké, že je potřeba je rozdělit na menší bloky, použijte Decoder nebo Encoder objekt poskytnutý metodou GetDecoder nebo metodou GetEncoder .

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

Zdroj:

UTF8Encoding.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Dekóduje posloupnost bajtů počínaje zadaným bajtovým ukazatelem na sadu znaků, které jsou uloženy od zadaného ukazatele znaků.

public:
 override int GetChars(System::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)>]
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int -> int

Parametry

bytes

Byte*

Ukazatel na první bajt pro dekódování.

byteCount

Int32

Počet bajtů, které se mají dekódovat.

chars

Char*

Ukazatel na umístění, ve kterém chcete začít psát výslednou sadu znaků.

charCount

Int32

Maximální počet znaků k zápisu.

Návraty

Int32

Skutečný počet znaků zapsaných v umístění určeném znakem chars.

Atributy

CLSCompliantAttribute

Výjimky

ArgumentNullException

bytes je null.

nebo

chars je null.

ArgumentOutOfRangeException

byteCount nebo charCount je menší než nula.

ArgumentException

Je povoleno zjišťování chyb a bytes obsahuje neplatnou posloupnost bajtů.

nebo

charCount je menší než výsledný počet znaků.

DecoderFallbackException

Došlo k záložnímu použití (další informace najdete v tématu Kódování znaků v .NET).

a

DecoderFallback je nastaveno na DecoderExceptionFallback.

Poznámky

Pokud chcete vypočítat přesnou velikost pole potřebnou GetChars k uložení výsledných znaků, zavolejte metodu GetCharCount . Pokud chcete vypočítat maximální velikost pole, zavolejte metodu GetMaxCharCount . Metoda GetCharCount obecně přiděluje méně paměti, zatímco GetMaxCharCount metoda obvykle provádí rychleji.

Při detekci chyb způsobí neplatná posloupnost vyvolání výjimky touto metodou ArgumentException . Bez detekce chyb se ignorují neplatné sekvence a nevyvolá se žádná výjimka.

Pokud rozsah bajtů, které se mají dekódovat, zahrnuje značku pořadí bajtů (BOM) a bajtové pole bylo vráceno metodou typu bez boM, znak U+FFFE je zahrnut do pole znaků vrácených touto metodou. Můžete ho odebrat voláním String.TrimStart metody.

Data, která se mají převést, například čtení dat ze streamu, můžou být k dispozici pouze v sekvenčních blocích. V tomto případě nebo pokud je množství dat tak velké, že je potřeba je rozdělit na menší bloky, použijte Decoder nebo Encoder objekt poskytnutý metodou GetDecoder nebo metodou GetEncoder .

Viz také

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

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

Zdroj:

UTF8Encoding.cs

Dekóduje posloupnost bajtů ze zadaného bajtového pole do zadaného znakového pole.

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

Parametry

bytes

Byte[]

Bajtové pole obsahující posloupnost bajtů k dekódování.

byteIndex

Int32

Index prvního bajtu pro dekódování.

byteCount

Int32

Počet bajtů, které se mají dekódovat.

chars

Char[]

Pole znaků, které bude obsahovat výslednou sadu znaků.

charIndex

Int32

Index, na kterém chcete začít psát výslednou sadu znaků.

Návraty

Int32

Skutečný počet znaků zapsaných do chars.

Výjimky

ArgumentNullException

bytes je null.

nebo

chars je null.

ArgumentOutOfRangeException

byteIndex nebo byteCountcharIndex je menší než nula.

nebo

byteIndex a byteCount neoznamujte platný rozsah v bytes.

nebo

charIndex není platný index v charssouboru .

ArgumentException

Je povoleno zjišťování chyb a bytes obsahuje neplatnou posloupnost bajtů.

nebo

chars nemá dostatečnou kapacitu od charIndex konce pole, aby vyhovoval výsledným znakům.

DecoderFallbackException

Došlo k záložnímu použití (další informace najdete v tématu Kódování znaků v .NET).

a

DecoderFallback je nastaveno na DecoderExceptionFallback.

Příklady

Následující příklad používá metodu GetChars k dekódování rozsahu prvků v bajtovém poli a uložení výsledku do pole znaků.

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

Poznámky

Pokud chcete vypočítat přesnou velikost pole potřebnou GetChars k uložení výsledných znaků, zavolejte metodu GetCharCount . Pokud chcete vypočítat maximální velikost pole, zavolejte metodu GetMaxCharCount . Metoda GetCharCount obecně přiděluje méně paměti, zatímco GetMaxCharCount metoda obvykle provádí rychleji.

Při detekci chyb způsobí neplatná posloupnost vyvolání výjimky touto metodou ArgumentException . Bez detekce chyb se ignorují neplatné sekvence a nevyvolá se žádná výjimka.

Pokud rozsah bajtů, které se mají dekódovat, zahrnuje značku pořadí bajtů (BOM) a bajtové pole bylo vráceno metodou typu bez boM, znak U+FFFE je zahrnut do pole znaků vrácených touto metodou. Můžete ho odebrat voláním String.TrimStart metody.

Data, která se mají převést, například čtení dat ze streamu, můžou být k dispozici pouze v sekvenčních blocích. V tomto případě nebo pokud je množství dat tak velké, že je potřeba je rozdělit na menší bloky, použijte DecoderEncoder metodu GetDecoder nebo metodu nebo metodu GetEncoder .

Viz také

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