ASCIIEncoding.GetChars Metoda
Definice
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í.
Návraty
Skutečný počet znaků zapsaných do chars
.
Poznámky
K výpočtu přesné velikosti požadované GetChars k uložení výsledných znaků použijte GetCharCount. K výpočtu maximální velikosti použijte GetMaxCharCount. Metoda GetCharCount obecně umožňuje přidělení méně paměti, zatímco GetMaxCharCount metoda obvykle provádí rychleji.
Data, která se mají převést, například data načtená z datového proudu, mohou být k dispozici pouze v sekvenčních blocích. V takovém případě nebo pokud je množství dat tak velké, že je potřeba je rozdělit na menší bloky, měli byste použít Decoder metodu GetDecoder nebo Encoder metodu nebo metoduGetEncoder.
ASCIIEncoding neposkytuje detekci chyb. Jakýkoli bajt větší než šestnáctkový 0x7F
je dekódován jako otazník Unicode ("?").
Upozornění
Z bezpečnostních důvodů byste měli použít UTF8Encoding, UnicodeEncodingnebo UTF32Encoding povolit detekci chyb.
Platí pro
GetChars(Byte*, Int32, Char*, Int32)
Důležité
Toto rozhraní API neodpovídá specifikaci CLS.
- Alternativa odpovídající specifikaci CLS
- System.Text.ASCIIEncoding.GetChars(Byte[], Int32, 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ů.
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
Skutečný počet znaků napsaných v umístění označeném znakem chars
.
- Atributy
Výjimky
byteCount
nebo charCount
je menší než nula.
charCount
je menší než výsledný počet znaků.
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
K výpočtu přesné velikosti pole vyžadované GetChars k uložení výsledných znaků používá GetCharCountaplikace . K výpočtu maximální velikosti pole by měla aplikace použít GetMaxCharCount. Metoda GetCharCount obecně umožňuje přidělení méně paměti, zatímco GetMaxCharCount metoda obvykle provádí rychleji.
Data, která se mají převést, například data načtená z datového proudu, mohou být k dispozici pouze v sekvenčních blocích. V takovém případě nebo pokud je množství dat tak velké, že je potřeba je rozdělit na menší bloky, aplikace by měla použít Decoder metodu GetDecoder nebo Encoder metodu nebo metoduGetEncoder.
ASCIIEncoding neposkytuje detekci chyb. Jakýkoli bajt větší než šestnáctkový 0x7F je dekódován jako otazník Unicode ("?").
Upozornění
Z bezpečnostních důvodů se doporučuje použít UTF8Encodingaplikaci , UnicodeEncodingnebo UTF32Encoding povolit detekci chyb.
Viz také
- GetCharCount(Byte[], Int32, Int32)
- GetMaxCharCount(Int32)
- GetDecoder()
- GetString(Byte[], Int32, Int32)
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
Skutečný počet znaků zapsaných do chars
.
Výjimky
byteIndex
nebo byteCount
charIndex
je menší než nula.
-nebo-
byteindex
a byteCount
neoznamujte platnou oblast v bytes
.
-nebo-
charIndex
není platný index v chars
.
chars
nemá dostatečnou kapacitu od charIndex
konce pole, aby vyhovovala výsledným znakům.
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 ukazuje, jak dekódovat rozsah prvků z bajtového pole a uložit výsledek do sady prvků v matici znaků Unicode.
using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
array<Char>^chars;
array<Byte>^bytes = {65,83,67,73,73,32,69,110,99,111,100,105,110,103,32,69,120,97,109,112,108,101};
ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
int charCount = ascii->GetCharCount( bytes, 6, 8 );
chars = gcnew array<Char>(charCount);
int charsDecodedCount = ascii->GetChars( bytes, 6, 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 ASCIIEncodingExample {
public static void Main() {
Char[] chars;
Byte[] bytes = new Byte[] {
65, 83, 67, 73, 73, 32, 69,
110, 99, 111, 100, 105, 110, 103,
32, 69, 120, 97, 109, 112, 108, 101
};
ASCIIEncoding ascii = new ASCIIEncoding();
int charCount = ascii.GetCharCount(bytes, 6, 8);
chars = new Char[charCount];
int charsDecodedCount = ascii.GetChars(bytes, 6, 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 ASCIIEncodingExample
Public Shared Sub Main()
Dim chars() As Char
Dim bytes() As Byte = { _
65, 83, 67, 73, 73, 32, 69, _
110, 99, 111, 100, 105, 110, 103, _
32, 69, 120, 97, 109, 112, 108, 101}
Dim ascii As New ASCIIEncoding()
Dim charCount As Integer = ascii.GetCharCount(bytes, 6, 8)
chars = New Char(charCount - 1) {}
Dim charsDecodedCount As Integer = ascii.GetChars(bytes, 6, 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 pole vyžadované GetChars k uložení výsledných znaků používá GetCharCountaplikace . K výpočtu maximální velikosti pole by měla aplikace použít GetMaxCharCount. Metoda GetCharCount obecně umožňuje přidělení méně paměti, zatímco GetMaxCharCount metoda obvykle provádí rychleji.
Data, která se mají převést, například data načtená z datového proudu, mohou být k dispozici pouze v sekvenčních blocích. V takovém případě nebo pokud je množství dat tak velké, že je potřeba je rozdělit na menší bloky, aplikace by měla použít Decoder metodu GetDecoder nebo Encoder metodu nebo metoduGetEncoder.
ASCIIEncoding neposkytuje detekci chyb. Jakýkoli bajt větší než šestnáctkový 0x7F je dekódován jako otazník Unicode ("?").
Upozornění
Z bezpečnostních důvodů se doporučuje použít UTF8Encodingaplikaci , UnicodeEncodingnebo UTF32Encoding povolit detekci chyb.
Viz také
- GetCharCount(Byte[], Int32, Int32)
- GetMaxCharCount(Int32)
- GetDecoder()
- GetString(Byte[], Int32, Int32)