Decoder.GetChars Méthode

Source:

Decoder.cs

Source:

Decoder.cs

Source:

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

Paramètres

Retours

Nombre réel de caractères écrits dans l’étendue indiquée par le paramètre chars.

Remarques

N’oubliez pas que l’objet Decoder enregistre l’état entre les appels à GetChars. Lorsque l’application a terminé avec un flux de données, elle doit définir le flush paramètre sur true pour s’assurer que les informations d’état sont vidées. Avec ce paramètre, le décodeur ignore les octets non valides à la fin du bloc de données et efface la mémoire tampon interne.

Pour calculer la taille d’étendue exacte qui GetChars nécessite de stocker les caractères résultants, l’application doit utiliser GetCharCount.

Si GetChars est appelé avec flush défini sur false, le décodeur stocke les octets de fin à la fin du bloc de données dans une mémoire tampon interne et les utilise dans l’opération de décodage suivante. L’application doit appeler GetCharCount sur un bloc de données immédiatement avant d’appeler GetChars sur le même bloc, afin que tous les octets de fin du bloc précédent soient inclus dans le calcul.

Si votre application doit convertir de nombreux segments d’un flux d’entrée, envisagez d’utiliser la Convert méthode . GetChars lève une exception si l’étendue de sortie n’est pas assez grande, mais Convert qu’elle occupe autant d’espace que possible et retourne les octets lus et les caractères écrits, à condition que le tableau de sortie autorise au moins deux caractères. Consultez également la Encoding.GetChars rubrique pour plus de commentaires.

Source:

Decoder.cs

Source:

Decoder.cs

Source:

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

Paramètres

Retours

Nombre réel de caractères écrits à l'emplacement indiqué par le paramètre chars.

Attributs

CLSCompliantAttribute ComVisibleAttribute SecurityCriticalAttribute

Exceptions

Remarques

N’oubliez pas que l’objet Decoder enregistre l’état entre les appels à GetChars. Lorsque l’application a terminé avec un flux de données, elle doit définir le flush paramètre sur true pour s’assurer que les informations d’état sont vidées. Avec ce paramètre, le décodeur ignore les octets non valides à la fin du bloc de données et efface la mémoire tampon interne.

Pour calculer la taille exacte de la mémoire tampon qui GetChars nécessite de stocker les caractères résultants, l’application doit utiliser GetCharCount.

Si GetChars est appelé avec flush défini sur false, le décodeur stocke les octets de fin à la fin du bloc de données dans une mémoire tampon interne et les utilise dans l’opération de décodage suivante. L’application doit appeler GetCharCount sur un bloc de données immédiatement avant d’appeler GetChars sur le même bloc, afin que tous les octets de fin du bloc précédent soient inclus dans le calcul.

Si votre application doit convertir de nombreux segments d’un flux d’entrée, envisagez d’utiliser la Convert méthode . GetChars lève une exception si la mémoire tampon de sortie n’est pas assez grande, mais Convert qu’elle occupe autant d’espace que possible et retourne les octets lus et les caractères écrits, à condition que le tableau de sortie autorise au moins deux caractères. Consultez également la Encoding.GetChars rubrique pour plus de commentaires.

Voir aussi

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

Source:

Decoder.cs

Source:

Decoder.cs

Source:

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

Paramètres

Retours

Nombre réel de caractères écrits dans chars.

Exceptions

Exemples

L’exemple suivant montre comment décoder une plage d’éléments à partir d’un tableau d’octets et les stocker dans un tableau de caractères Unicode. La GetCharCount méthode est utilisée pour calculer le nombre de caractères nécessaires pour stocker les éléments décodés dans le tableau bytes. La GetChars méthode décode les éléments spécifiés dans le tableau d’octets et les stocke dans le nouveau tableau de caractères.

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

Remarques

N’oubliez pas que l’objet Decoder enregistre l’état entre les appels à GetChars. Lorsque l’application a terminé avec un flux de données, elle doit définir le flush paramètre sur true pour s’assurer que les informations d’état sont vidées. Avec ce paramètre, le décodeur ignore les octets non valides à la fin du bloc de données et efface la mémoire tampon interne.

Pour calculer la taille exacte du tableau qui GetChars nécessite de stocker les caractères résultants, l’application doit utiliser GetCharCount.

Si GetChars est appelé avec flush défini sur false, le décodeur stocke les octets de fin à la fin du bloc de données dans une mémoire tampon interne et les utilise dans l’opération de décodage suivante. L’application doit appeler GetCharCount sur un bloc de données immédiatement avant d’appeler GetChars sur le même bloc, afin que tous les octets de fin du bloc précédent soient inclus dans le calcul.

Si votre application doit convertir de nombreux segments d’un flux d’entrée, envisagez d’utiliser la Convert méthode . GetChars lève une exception si la mémoire tampon de sortie n’est pas assez grande, mais Convert qu’elle occupe autant d’espace que possible et retourne les octets lus et les caractères écrits, à condition que le tableau de sortie autorise au moins deux caractères. Consultez également la Encoding.GetChars rubrique pour plus de commentaires.

Voir aussi

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

Source:

Decoder.cs

Source:

Decoder.cs

Source:

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

Paramètres

Retours

Nombre réel de caractères écrits dans le paramètre chars.

Exceptions

Remarques

N’oubliez pas que l’objet Decoder enregistre l’état entre les appels à GetChars. Lorsque l’application est terminée avec un flux de données, elle doit définir le flush paramètre sur pour true s’assurer que les informations d’état sont vidées. Avec ce paramètre, le décodeur ignore les octets non valides à la fin du bloc de données et efface la mémoire tampon interne.

Pour calculer la taille exacte du tableau qui GetChars nécessite de stocker les caractères résultants, l’application doit utiliser GetCharCount.

Si GetChars est appelé avec flush la valeur définie sur false, le décodeur stocke les octets de fin à la fin du bloc de données dans une mémoire tampon interne et les utilise dans l’opération de décodage suivante. L’application doit appeler GetCharCount sur un bloc de données immédiatement avant d’appeler GetChars sur le même bloc, afin que tous les octets de fin du bloc précédent soient inclus dans le calcul.

Si votre application doit convertir de nombreux segments d’un flux d’entrée, envisagez d’utiliser la Convert méthode . GetChars lève une exception si la mémoire tampon de sortie n’est pas assez grande, mais Convert remplit autant d’espace que possible et retourne les octets lus et les caractères écrits, à condition que le tableau de sortie autorise au moins deux caractères. Consultez également la Encoding.GetChars rubrique pour plus de commentaires.

Voir aussi

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