Decoder.GetChars Methode

Quelle:

Decoder.cs

Quelle:

Decoder.cs

Quelle:

Decoder.cs

public:
 virtual int GetChars(ReadOnlySpan<System::Byte> bytes, Span<char> chars, bool flush);

public virtual int GetChars (ReadOnlySpan<byte> bytes, Span<char> chars, bool flush);

abstract member GetChars : ReadOnlySpan<byte> * Span<char> * bool -> int
override this.GetChars : ReadOnlySpan<byte> * Span<char> * bool -> int

Public Overridable Function GetChars (bytes As ReadOnlySpan(Of Byte), chars As Span(Of Char), flush As Boolean) As Integer

Parameter

Gibt zurück

Die tatsächliche Anzahl der Zeichen, die an der durch den chars-Parameter angegebenen Spanne geschrieben wurden.

Hinweise

Denken Sie daran, dass das -Objekt den Decoder Zustand zwischen Aufrufen von GetCharsspeichert. Wenn die Anwendung mit einem Datenstrom fertig ist, sollte sie den flush Parameter auf true festlegen, um sicherzustellen, dass die Zustandsinformationen geleert werden. Mit dieser Einstellung ignoriert der Decoder ungültige Bytes am Ende des Datenblocks und löscht den internen Puffer.

Um die genaue Spannweite zu berechnen, die GetChars zum Speichern der resultierenden Zeichen erforderlich ist, sollte die Anwendung verwenden GetCharCount.

Wenn GetChars mit flush festgelegt auf falseaufgerufen wird, speichert der Decoder nachfolgende Bytes am Ende des Datenblocks in einem internen Puffer und verwendet sie im nächsten Decodierungsvorgang. Die Anwendung sollte einen Datenblock unmittelbar vor dem Aufrufen GetChars desselben Blocks aufrufenGetCharCount, damit alle nachfolgenden Bytes aus dem vorherigen Block in die Berechnung einbezogen werden.

Wenn Ihre Anwendung viele Segmente eines Eingabedatenstroms konvertieren soll, sollten Sie die Convert -Methode verwenden. GetChars löst eine Ausnahme aus, wenn die Ausgabespanne nicht groß genug ist, aber Convert so viel Speicherplatz wie möglich füllt und die gelesenen Bytes und geschriebenen Zeichen zurückgibt, sofern das Ausgabearray mindestens zwei Zeichen zulässt. Weitere Kommentare finden Sie auch im Encoding.GetChars Thema.

Quelle:

Decoder.cs

Quelle:

Decoder.cs

Quelle:

Decoder.cs

public:
 virtual int GetChars(System::Byte* bytes, int byteCount, char* chars, int charCount, bool flush);

[System.CLSCompliant(false)]
public virtual int GetChars (byte* bytes, int byteCount, char* chars, int charCount, bool flush);

[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public virtual int GetChars (byte* bytes, int byteCount, char* chars, int charCount, bool flush);

[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public virtual int GetChars (byte* bytes, int byteCount, char* chars, int charCount, bool flush);

[<System.CLSCompliant(false)>]
abstract member GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int

[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int

[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Security.SecurityCritical>]
abstract member GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int

Parameter

Gibt zurück

Die tatsächliche Anzahl der Zeichen, die an der durch den chars-Parameter angegebenen Position geschrieben wurden.

Attribute

CLSCompliantAttribute ComVisibleAttribute SecurityCriticalAttribute

Ausnahmen

Hinweise

Denken Sie daran, dass das -Objekt den Decoder Zustand zwischen Aufrufen von GetCharsspeichert. Wenn die Anwendung mit einem Datenstrom fertig ist, sollte sie den flush Parameter auf true festlegen, um sicherzustellen, dass die Zustandsinformationen geleert werden. Mit dieser Einstellung ignoriert der Decoder ungültige Bytes am Ende des Datenblocks und löscht den internen Puffer.

Um die genaue Puffergröße zu berechnen, die GetChars zum Speichern der resultierenden Zeichen erforderlich ist, sollte die Anwendung verwenden GetCharCount.

Wenn GetChars mit flush festgelegt auf falseaufgerufen wird, speichert der Decoder nachfolgende Bytes am Ende des Datenblocks in einem internen Puffer und verwendet sie im nächsten Decodierungsvorgang. Die Anwendung sollte einen Datenblock unmittelbar vor dem Aufrufen GetChars desselben Blocks aufrufenGetCharCount, damit alle nachfolgenden Bytes aus dem vorherigen Block in die Berechnung einbezogen werden.

Wenn Ihre Anwendung viele Segmente eines Eingabedatenstroms konvertieren soll, sollten Sie die Convert -Methode verwenden. GetChars löst eine Ausnahme aus, wenn der Ausgabepuffer nicht groß genug ist, aber Convert so viel Speicherplatz wie möglich füllt und die gelesenen Bytes und geschriebenen Zeichen zurückgibt, sofern das Ausgabearray mindestens zwei Zeichen zulässt. Weitere Kommentare finden Sie auch im Encoding.GetChars Thema.

Weitere Informationen

• GetCharCount(Byte*, Int32, Boolean)
• Reset()

Quelle:

Decoder.cs

Quelle:

Decoder.cs

Quelle:

Decoder.cs

public:
 abstract int GetChars(cli::array <System::Byte> ^ bytes, int byteIndex, int byteCount, cli::array <char> ^ chars, int charIndex);

public abstract int GetChars (byte[] bytes, int byteIndex, int byteCount, char[] chars, int charIndex);

abstract member GetChars : byte[] * int * int * char[] * int -> int

Public MustOverride 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 veranschaulicht, wie sie einen Bereich von Elementen aus einem Bytearray decodieren und in einem Unicode-Zeichenarray speichern. Die GetCharCount -Methode wird verwendet, um die Anzahl der Zeichen zu berechnen, die zum Speichern der decodierten Elemente im Array byteserforderlich sind. Die GetChars -Methode decodiert die angegebenen Elemente im Bytearray und speichert sie im neuen Zeichenarray.

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};
   Decoder^ uniDecoder = Encoding::Unicode->GetDecoder();
   int charCount = uniDecoder->GetCharCount( bytes, 0, bytes->Length );
   chars = gcnew array<Char>(charCount);
   int charsDecodedCount = uniDecoder->GetChars( bytes, 0, bytes->Length, 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();
}

/* This code example produces the following output.

7 characters used to decode bytes.
Decoded chars: [U][n][i][c][o][d][e]

*/

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

        Decoder uniDecoder = Encoding.Unicode.GetDecoder();

        int charCount = uniDecoder.GetCharCount(bytes, 0, bytes.Length);
        chars = new Char[charCount];
        int charsDecodedCount = uniDecoder.GetChars(bytes, 0, bytes.Length, 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();
    }
}

/* This code example produces the following output.

7 characters used to decode bytes.
Decoded chars: [U][n][i][c][o][d][e]

*/

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 uniDecoder As Decoder = Encoding.Unicode.GetDecoder()
        
        Dim charCount As Integer = uniDecoder.GetCharCount(bytes, 0, bytes.Length)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = _
            uniDecoder.GetChars(bytes, 0, bytes.Length, 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

'This code example produces the following output.
'
'7 characters used to decode bytes.
'Decoded chars: [U][n][i][c][o][d][e]
'

Hinweise

Denken Sie daran, dass das -Objekt den Decoder Zustand zwischen Aufrufen von GetCharsspeichert. Wenn die Anwendung mit einem Datenstrom fertig ist, sollte sie den flush Parameter auf true festlegen, um sicherzustellen, dass die Zustandsinformationen geleert werden. Mit dieser Einstellung ignoriert der Decoder ungültige Bytes am Ende des Datenblocks und löscht den internen Puffer.

Um die genaue Arraygröße zu berechnen, die GetChars zum Speichern der resultierenden Zeichen erforderlich ist, sollte die Anwendung verwenden GetCharCount.

Wenn GetChars mit flush festgelegt auf falseaufgerufen wird, speichert der Decoder nachfolgende Bytes am Ende des Datenblocks in einem internen Puffer und verwendet sie im nächsten Decodierungsvorgang. Die Anwendung sollte einen Datenblock unmittelbar vor dem Aufrufen GetChars desselben Blocks aufrufenGetCharCount, damit alle nachfolgenden Bytes aus dem vorherigen Block in die Berechnung einbezogen werden.

Wenn Ihre Anwendung viele Segmente eines Eingabedatenstroms konvertieren soll, sollten Sie die Convert -Methode verwenden. GetChars löst eine Ausnahme aus, wenn der Ausgabepuffer nicht groß genug ist, aber Convert so viel Speicherplatz wie möglich füllt und die gelesenen Bytes und geschriebenen Zeichen zurückgibt, sofern das Ausgabearray mindestens zwei Zeichen zulässt. Weitere Kommentare finden Sie auch im Encoding.GetChars Thema.

Weitere Informationen

• GetCharCount(Byte[], Int32, Int32)
• Reset()

Quelle:

Decoder.cs

Quelle:

Decoder.cs

Quelle:

Decoder.cs

public:
 virtual int GetChars(cli::array <System::Byte> ^ bytes, int byteIndex, int byteCount, cli::array <char> ^ chars, int charIndex, bool flush);

public virtual int GetChars (byte[] bytes, int byteIndex, int byteCount, char[] chars, int charIndex, bool flush);

abstract member GetChars : byte[] * int * int * char[] * int * bool -> int
override this.GetChars : byte[] * int * int * char[] * int * bool -> int

Public Overridable Function GetChars (bytes As Byte(), byteIndex As Integer, byteCount As Integer, chars As Char(), charIndex As Integer, flush As Boolean) As Integer

Parameter

Gibt zurück

Die tatsächliche Anzahl der Zeichen, die in den chars-Parameter geschrieben wird.

Ausnahmen

Hinweise

Denken Sie daran, dass das -Objekt den Decoder Zustand zwischen Aufrufen von GetCharsspeichert. Wenn die Anwendung mit einem Datenstrom fertig ist, sollte sie den flush Parameter auf true festlegen, um sicherzustellen, dass die Statusinformationen geleert werden. Mit dieser Einstellung ignoriert der Decoder ungültige Bytes am Ende des Datenblocks und löscht den internen Puffer.

Um die genaue Arraygröße zu berechnen, die GetChars zum Speichern der resultierenden Zeichen erforderlich ist, sollte die Anwendung verwenden GetCharCount.

Wenn GetChars aufgerufen wird und flush auf falsefestgelegt ist, speichert der Decoder nachfolgende Bytes am Ende des Datenblocks in einem internen Puffer und verwendet sie im nächsten Decodierungsvorgang. Die Anwendung sollte einen Datenblock unmittelbar vor dem Aufrufen GetChars desselben Blocks aufrufenGetCharCount, damit alle nachgestellten Bytes aus dem vorherigen Block in die Berechnung einbezogen werden.

Wenn Ihre Anwendung viele Segmente eines Eingabedatenstroms konvertieren soll, sollten Sie die Convert -Methode verwenden. GetChars löst eine Ausnahme aus, wenn der Ausgabepuffer nicht groß genug ist, aber Convert so viel Speicherplatz wie möglich auffüllt und die gelesenen Bytes und geschriebenen Zeichen zurückgibt, sofern das Ausgabearray mindestens zwei Zeichen zulässt. Weitere Kommentare finden Sie auch im Encoding.GetChars Thema.

Weitere Informationen

• GetCharCount(Byte[], Int32, Int32, Boolean)
• Reset()