Nyelv

UTF32Encoding.GetChars Metódus

Definíció

Névtér:
System.Text
Szerelvények:
mscorlib.dll, System.Text.Encoding.Extensions.dll
Szerelvények:
netstandard.dll, System.Text.Encoding.Extensions.dll
Szerelvény:
System.Text.Encoding.Extensions.dll
Szerelvény:
mscorlib.dll
Szerelvény:
netstandard.dll

Bájtok sorozatát kódolja karakterkészletté.

Túlterhelések

Név Description
GetChars(Byte*, Int32, Char*, Int32)

A megadott bájtmutatótól kezdve a bájtok sorozatát a megadott karaktermutatótól kezdődően tárolt karakterkészletté dekódolja.
GetChars(Byte[], Int32, Int32, Char[], Int32)

Bájtok sorozatát dekódolja a megadott bájttömbből a megadott karaktertömbbe.

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

Forrás:
UTF32Encoding.cs
Forrás:
UTF32Encoding.cs
Forrás:
UTF32Encoding.cs
Forrás:
UTF32Encoding.cs
Forrás:
UTF32Encoding.cs

Fontos

Ez az API nem CLS-kompatibilis.

A megadott bájtmutatótól kezdve a bájtok sorozatát a megadott karaktermutatótól kezdődően tárolt karakterkészletté dekódolja.

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

Paraméterek

bytes
Byte*

A dekódolni kívánt első bájtra mutató mutató.

byteCount
Int32

A dekódolni kívánt bájtok száma.

chars
Char*

Az eredményként kapott karakterkészlet írásának megkezdéséhez mutató mutató.

charCount
Int32

Az írandó karakterek maximális száma.

Válaszok

Int32

A megadott helyen charsírt karakterek tényleges száma.

Attribútumok
CLSCompliantAttribute SecurityCriticalAttribute

Kivételek

ArgumentNullException

bytes az null.

-vagy-

chars az null.

ArgumentOutOfRangeException

byteCount vagy charCount kisebb, mint nulla.

ArgumentException

A hibaészlelés engedélyezve van, és bytes érvénytelen bájtsort tartalmaz.

-vagy-

charCount kisebb, mint az eredményként kapott karakterek száma.

DecoderFallbackException

Hiba történt (további információ: Acharacter kódolása a .NET)

-és-

DecoderFallback DecoderExceptionFallbackértékre van állítva.

Megjegyzések

Az eredményként kapott karakterek tárolásához szükséges GetChars pontos tömbméret kiszámításához hívja meg a metódust GetCharCount . A maximális tömbméret kiszámításához hívja meg a metódust GetMaxCharCount . A GetCharCount metódus általában kevesebb memóriát foglal le, míg a GetMaxCharCount metódus általában gyorsabban fut.

Hibaészlelés esetén az érvénytelen sorrend miatt ez a metódus egy ArgumentException. Hibaészlelés nélkül a rendszer figyelmen kívül hagyja az érvénytelen sorozatokat, és nincs kivétel.

Ha a dekódolandó bájtok tartománya tartalmazza a bájtsorrendjelet (BOM), és a bájttömböt nem BOM-tudatos típusú metódussal adták vissza, az U+FFFE karakter szerepel a metódus által visszaadott karaktertömbben. A metódus meghívásával eltávolíthatja.String.TrimStart

Az átalakítandó adatok, például a streamből beolvasott adatok csak szekvenciális blokkokban érhetők el. Ebben az esetben, vagy ha az adatok mennyisége olyan nagy, hogy kisebb blokkokra kell osztani, az alkalmazás a Decoder metódus vagy Encoder a GetDecoder metódus által GetEncoder megadott vagy megadott adatokat használja.

Lásd még

A következőre érvényes:

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

Forrás:
UTF32Encoding.cs
Forrás:
UTF32Encoding.cs
Forrás:
UTF32Encoding.cs
Forrás:
UTF32Encoding.cs
Forrás:
UTF32Encoding.cs

Bájtok sorozatát dekódolja a megadott bájttömbből a megadott karaktertömbbe.

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

Paraméterek

bytes
Byte[]

A dekódolni kívánt bájtok sorozatát tartalmazó bájttömb.

byteIndex
Int32

A dekódolni kívánt első bájt indexe.

byteCount
Int32

A dekódolni kívánt bájtok száma.

chars
Char[]

Az eredményként kapott karakterkészletet tartalmazó karaktertömb.

charIndex
Int32

Az index, amelynél elkezdi írni az eredményként kapott karakterkészletet.

Válaszok

Int32

A beírt charskarakterek tényleges száma.

Kivételek

ArgumentNullException

bytes az null.

-vagy-

chars az null.

ArgumentOutOfRangeException

byteIndex vagy byteCountcharIndex kisebb, mint nulla.

-vagy-

byteIndex és byteCount ne jelölje az érvényes tartományt a következőben bytes: .

-vagy-

charIndex érvénytelen index a következőben chars: .

ArgumentException

A hibaészlelés engedélyezve van, és bytes érvénytelen bájtsort tartalmaz.

-vagy-

chars nem rendelkezik elegendő kapacitással a tömb végétől charIndex a kapott karakterek elhelyezéséhez.

DecoderFallbackException

Hiba történt (további információ: Acharacter kódolása a .NET)

-és-

DecoderFallback DecoderExceptionFallbackértékre van állítva.

Példák

Az alábbi példa egy karakterláncot bájtok tömbjeként kódol, majd a bájtokat karaktertömbbe dekódolja.

using System;
using System.Text;

public class SamplesUTF32Encoding  {

   public static void Main()  {

      // Create two instances of UTF32Encoding: one with little-endian byte order and one with big-endian byte order.
      UTF32Encoding u32LE = new UTF32Encoding( false, true, true );
      UTF32Encoding u32BE = new UTF32Encoding( true, true, true );

      // Create byte arrays from the same string containing the following characters:
      //    Latin Small Letter Z (U+007A)
      //    Latin Small Letter A (U+0061)
      //    Combining Breve (U+0306)
      //    Latin Small Letter AE With Acute (U+01FD)
      //    Greek Small Letter Beta (U+03B2)
      //    a high-surrogate value (U+D8FF)
      //    a low-surrogate value (U+DCFF)
      String myStr = "za\u0306\u01FD\u03B2\uD8FF\uDCFF";

      // barrBE uses the big-endian byte order.
      byte[] barrBE = new byte[u32BE.GetByteCount( myStr )];
      u32BE.GetBytes( myStr, 0, myStr.Length, barrBE, 0 );

      // barrLE uses the little-endian byte order.
      byte[] barrLE = new byte[u32LE.GetByteCount( myStr )];
      u32LE.GetBytes( myStr, 0, myStr.Length, barrLE, 0 );

      // Get the char counts and decode the byte arrays.
      Console.Write( "BE array with BE encoding : " );
      PrintCountsAndChars( barrBE, u32BE );
      Console.Write( "LE array with LE encoding : " );
      PrintCountsAndChars( barrLE, u32LE );

      // Decode the byte arrays using an encoding with a different byte order.
      Console.Write( "BE array with LE encoding : " );
      try  {
         PrintCountsAndChars( barrBE, u32LE );
      }
      catch ( System.ArgumentException e )  {
         Console.WriteLine( e.Message );
      }

      Console.Write( "LE array with BE encoding : " );
      try  {
         PrintCountsAndChars( barrLE, u32BE );
      }
      catch ( System.ArgumentException e )  {
         Console.WriteLine( e.Message );
      }
   }

   public static void PrintCountsAndChars( byte[] bytes, Encoding enc )  {

      // Display the name of the encoding used.
      Console.Write( "{0,-25} :", enc.ToString() );

      // Display the exact character count.
      int iCC  = enc.GetCharCount( bytes );
      Console.Write( " {0,-3}", iCC );

      // Display the maximum character count.
      int iMCC = enc.GetMaxCharCount( bytes.Length );
      Console.Write( " {0,-3} :", iMCC );

      // Decode the bytes and display the characters.
      char[] chars = new char[iCC];
      enc.GetChars( bytes, 0, bytes.Length, chars, 0 );
      Console.WriteLine( chars );
   }
}

Imports System.Text

Public Class SamplesUTF32Encoding   

   Public Shared Sub Main()

      ' Create two instances of UTF32Encoding: one with little-endian byte order and one with big-endian byte order.
      Dim u32LE As New UTF32Encoding(False, True, True)
      Dim u32BE As New UTF32Encoding(True, True, True)


      ' Create byte arrays from the same string containing the following characters:
      '    Latin Small Letter Z (U+007A)
      '    Latin Small Letter A (U+0061)
      '    Combining Breve (U+0306)
      '    Latin Small Letter AE With Acute (U+01FD)
      '    Greek Small Letter Beta (U+03B2)
      '    a high-surrogate value (U+D8FF)
      '    a low-surrogate value (U+DCFF)
      Dim myStr As String = "za" & ChrW(&H0306) & ChrW(&H01FD) & ChrW(&H03B2) & ChrW(&HD8FF) & ChrW(&HDCFF)

      ' barrBE uses the big-endian byte order.
      ' NOTE: In Visual Basic, arrays contain one extra element by default.
      '       The following line creates an array with the exact number of elements required.
      Dim barrBE(u32BE.GetByteCount(myStr) - 1) As Byte
      u32BE.GetBytes(myStr, 0, myStr.Length, barrBE, 0)

      ' barrLE uses the little-endian byte order.
      ' NOTE: In Visual Basic, arrays contain one extra element by default.
      '       The following line creates an array with the exact number of elements required.
      Dim barrLE(u32LE.GetByteCount(myStr) - 1) As Byte
      u32LE.GetBytes(myStr, 0, myStr.Length, barrLE, 0)


      ' Get the char counts and decode the byte arrays.
      Console.Write("BE array with BE encoding : ")
      PrintCountsAndChars(barrBE, u32BE)
      Console.Write("LE array with LE encoding : ")
      PrintCountsAndChars(barrLE, u32LE)


      ' Decode the byte arrays using an encoding with a different byte order.
      Console.Write("BE array with LE encoding : ")
      Try
         PrintCountsAndChars(barrBE, u32LE)
      Catch e As System.ArgumentException
         Console.WriteLine(e.Message)
      End Try

      Console.Write("LE array with BE encoding : ")
      Try
         PrintCountsAndChars(barrLE, u32BE)
      Catch e As System.ArgumentException
         Console.WriteLine(e.Message)
      End Try

   End Sub


   Public Shared Sub PrintCountsAndChars(bytes() As Byte, enc As Encoding)

      ' Display the name of the encoding used.
      Console.Write("{0,-25} :", enc.ToString())

      ' Display the exact character count.
      Dim iCC As Integer = enc.GetCharCount(bytes)
      Console.Write(" {0,-3}", iCC)

      ' Display the maximum character count.
      Dim iMCC As Integer = enc.GetMaxCharCount(bytes.Length)
      Console.Write(" {0,-3} :", iMCC)

      ' Decode the bytes and display the characters.
      Dim chars(iCC) As Char
      enc.GetChars(bytes, 0, bytes.Length, chars, 0)
      Console.WriteLine(chars)

   End Sub

End Class

Megjegyzések

Az eredményként kapott karakterek tárolásához szükséges GetChars pontos tömbméret kiszámításához hívja meg a metódust GetCharCount . A maximális tömbméret kiszámításához hívja meg a metódust GetMaxCharCount . A GetCharCount metódus általában kevesebb memóriát foglal le, míg a GetMaxCharCount metódus általában gyorsabban fut.

Hibaészlelés esetén az érvénytelen sorrend miatt ez a metódus egy ArgumentException. Hibaészlelés nélkül a rendszer figyelmen kívül hagyja az érvénytelen sorozatokat, és nincs kivétel.

Ha a dekódolandó bájtok tartománya tartalmazza a bájtsorrendjelet (BOM), és a bájttömböt nem BOM-tudatos típusú metódussal adták vissza, az U+FFFE karakter szerepel a metódus által visszaadott karaktertömbben. A metódus meghívásával eltávolíthatja.String.TrimStart

Az átalakítandó adatok, például a streamből beolvasott adatok csak szekvenciális blokkokban érhetők el. Ebben az esetben, vagy ha az adatok mennyisége olyan nagy, hogy kisebb blokkokra kell osztani, az alkalmazás a Decoder metódus vagy Encoder a GetDecoder metódus által GetEncoder megadott vagy megadott adatokat használja.

Lásd még

A következőre érvényes: