UnicodeEncoding.GetChars Metoda

Definice

Obor názvů:

System.Text

Sestavení:

System.Text.Encoding.Extensions.dll

Dekóduje posloupnost bajtů na sadu znaků.

Přetížení

GetChars(Byte*, Int32, Char*, Int32)	Dekóduje posloupnost bajtů počínaje zadaným bajtovým ukazatelem do sady znaků, které jsou uloženy od zadaného ukazatele znaků.
GetChars(Byte[], Int32, Int32, Char[], Int32)	Dekóduje posloupnost bajtů ze zadaného pole bajtů do zadaného pole znaků.

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

Zdroj:

UnicodeEncoding.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Dekóduje posloupnost bajtů počínaje zadaným bajtovým ukazatelem do sady 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, který chcete dekódovat.

byteCount

Int32

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

chars

Char*

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

charCount

Int32

Maximální počet znaků, které se mají napsat.

Návraty

Int32

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

Atributy

CLSCompliantAttribute

Výjimky

ArgumentNullException

bytes je null (Nothing).

-nebo-

chars je null (Nothing).

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 náhradnímu řešení (další informace najdete v tématu Kódování znaků v .NET).

-A-

DecoderFallback je nastavená na DecoderExceptionFallbackhodnotu .

Poznámky

K výpočtu přesné velikosti pole, která GetChars je nutná k uložení výsledných znaků, aplikace používá GetCharCount. K výpočtu maximální velikosti pole by aplikace měla použít GetMaxCharCount. Metoda GetCharCount obecně přiděluje méně paměti, zatímco GetMaxCharCount metoda obecně provádí rychleji.

Při detekci chyb způsobí neplatná sekvence, že tato metoda vyvolá ArgumentExceptionchybu . Bez detekce chyb se neplatné sekvence ignorují a nedochází k žádné výjimce.

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

Data, která se mají převést, například data přečtená 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 do menších bloků, měla by aplikace použít Decoder objekt nebo Encoder poskytnutý metodou GetDecoder nebo GetEncoder .

Viz také

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

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

Zdroj:

UnicodeEncoding.cs

Dekóduje posloupnost bajtů ze zadaného pole bajtů 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[]

Pole bajtů obsahující posloupnost bajtů, které se mají dekódovat.

byteIndex

Int32

Index prvního bajtu, který se 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, ve 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 (Nothing).

-nebo-

chars je null (Nothing).

ArgumentOutOfRangeException

byteIndex nebo byteCountcharIndex je menší než nula.

-nebo-

byteindex a byteCount neoznamujte platnou oblast v bytessouboru .

-nebo-

charIndex není platný index v nástroji chars.

ArgumentException

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

-nebo-

chars nemá dostatečnou kapacitu od charIndex konce pole pro umístění výsledných znaků.

DecoderFallbackException

Došlo k náhradnímu řešení (další informace najdete v tématu Kódování znaků v .NET).

-A-

DecoderFallback je nastavená na DecoderExceptionFallbackhodnotu .

Příklady

Následující příklad ukazuje, jak pomocí GetChars metody dekódovat oblast prvků v bajtovém poli a uložit výsledek do pole znaků.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Char>^chars;
   array<Byte>^bytes = {85,0,110,0,105,0,99,0,111,0,100,0,101,0};
   UnicodeEncoding^ Unicode = gcnew UnicodeEncoding;
   int charCount = Unicode->GetCharCount( bytes, 2, 8 );
   chars = gcnew array<Char>(charCount);
   int charsDecodedCount = Unicode->GetChars( bytes, 2, 8, 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 UnicodeEncodingExample {
    public static void Main() {
        Char[] chars;
        Byte[] bytes = new Byte[] {
            85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0
        };

        UnicodeEncoding Unicode = new UnicodeEncoding();

        int charCount = Unicode.GetCharCount(bytes, 2, 8);
        chars = new Char[charCount];
        int charsDecodedCount = Unicode.GetChars(bytes, 2, 8, 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 UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim chars() As Char
        Dim bytes() As Byte = {85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0}
        
        Dim uni As New UnicodeEncoding()
        
        Dim charCount As Integer = uni.GetCharCount(bytes, 2, 8)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = uni.GetChars(bytes, 2, 8, 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

K výpočtu přesné velikosti matice potřebné GetChars k uložení výsledných znaků aplikace používá GetCharCount. K výpočtu maximální velikosti pole by aplikace měla použít GetMaxCharCount. Metoda GetCharCount obecně přiděluje méně paměti, zatímco GetMaxCharCount metoda obecně provádí rychleji.

Při detekci chyb způsobí neplatná sekvence, že tato metoda vyvolá ArgumentExceptionchybu . Bez detekce chyb se neplatné sekvence ignorují a nedochází k žádné výjimce.

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

Data, která se mají převést, například data přečtená 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 do menších bloků, měla by aplikace použít Decoder metodu nebo EncoderGetDecoder metodu nebo metodu GetEncoder .

Viz také

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