UTF8Encoding.GetChars Metoda

Reference

Definice

Obor názvů:: System.Text

Sestavení:: System.Text.Encoding.Extensions.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Dekóduje posloupnost bajtů do sady znaků.

Přetížení

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 ukazatelem bajtů 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 pole znaků.

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

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 k dekódování.

chars: Span<Char>

Rozsah, který bude obsahovat výslednou sadu znaků.

Návraty

Int32

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

Poznámky

Chcete-li 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é mají být dekódovány, zahrnuje značku pořadí bajtů (BOM) a rozsah bajtů byl vrácen metodou typu bez boM, znak U+FFFE je zahrnut do rozsahu znaků vrácených touto metodou. Můžete ho String.TrimStart odebrat voláním metody.

Data, která se mají převést, například data načtená ze streamu, můžou být dostupná jenom 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 .

Platí pro

GetChars(Byte, Int32, Char, Int32)

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Dekóduje posloupnost bajtů počínaje zadaným ukazatelem bajtů 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)]
[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

Parametry

bytes: Byte*

Ukazatel na první bajt, který dekóduje.

byteCount: Int32

Počet bajtů k dekódování

chars: Char*

Ukazatel na umístění, ve kterém se má začít psát výsledná sada znaků.

charCount: Int32

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

Návraty

Int32

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

Atributy: CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Výjimky

ArgumentNullException

bytes je null.

-nebo- chars je null.

ArgumentOutOfRangeException

byteCount nebo charCount je menší než nula.

ArgumentException

Detekce chyb je povolená a bytes obsahuje neplatnou posloupnost bajtů.

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

DecoderFallbackException

Došlo k záložnímu obnovení (další informace najdete v tématu Kódování znaků v .NET). -a- DecoderFallback je nastavena na DecoderExceptionFallbackhodnotu .

Poznámky

Chcete-li vypočítat přesnou velikost pole potřebnou GetChars k uložení výsledných znaků, zavolejte metodu GetCharCount . Chcete-li 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, je znak U+FFFE zahrnut do pole znaků vrácených touto metodou. Můžete ho String.TrimStart odebrat voláním metody.

Viz také

Platí pro

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

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

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, který má dekódovat.

byteCount: Int32

Počet bajtů k dekódování

chars: Char[]

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

charIndex: Int32

Index, na kterém se má začít psát výsledná sada 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 byteCount charIndex je menší než nula.

-nebo- byteindex a byteCount neoznamujte platnou oblast v bytes.

-nebo- charIndex není platný index v chars.

ArgumentException

Detekce chyb je povolená a bytes obsahuje neplatnou posloupnost bajtů.

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

DecoderFallbackException

Došlo k záložnímu obnovení (další informace najdete v tématu Kódování znaků v .NET). -a- DecoderFallback je nastavena na DecoderExceptionFallbackhodnotu .

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 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

Poznámky

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.

Data, která se mají převést, například data načtená ze streamu, můžou být dostupná jenom 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 metodu GetDecoder nebo metodu nebo Encoder metodu nebo metoduGetEncoder.

Viz také

Platí pro

Sdílet prostřednictvím

UTF8Encoding.GetChars Metoda

Definice

Přetížení

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

Parametry

Návraty

Poznámky

Platí pro

GetChars(Byte, Int32, Char, Int32)

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

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

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Další materiály

Sdílet prostřednictvím

UTF8Encoding.GetChars Metoda

Definice

Přetížení

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

Parametry

Návraty

Poznámky

Platí pro

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

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

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

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Další materiály

GetChars(Byte, Int32, Char, Int32)