Encoding.GetChars Method (array<Byte[], Int32, Int32)

Parameters

• bytes
  Type: array<System.Byte[]
  The byte array containing the sequence of bytes to decode.

• index
  Type: System.Int32
  The zero-based index of the first byte to decode.

• count
  Type: System.Int32
  The number of bytes to decode.

Return Value

Type: array<System.Char[]
A character array containing the results of decoding the specified sequence of bytes.

Imports System.Text

Public Class Example

   Public Shared Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)

      ' Create two instances of UTF32Encoding: one with little-endian byte order and one with big-endian byte order.
      Dim u32LE As Encoding = Encoding.GetEncoding("utf-32")
      Dim u32BE As Encoding = Encoding.GetEncoding("utf-32BE")

      ' Use a 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)
      Dim myStr As String = "za" & ChrW(&H306) & ChrW(&H1FD) & ChrW(&H3B2)

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

      ' Encode the string using the little-endian byte order.
      ' NOTE: In VB.NET, arrays contain one extra element by default.
      '       The following line creates barrLE 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, decode eight bytes starting at index 0,
      ' and print out the counts and the resulting bytes.
      outputBlock.Text &= "BE array with BE encoding : "
      PrintCountsAndChars(outputBlock, barrBE, 0, 8, u32BE)
      outputBlock.Text &= "LE array with LE encoding : "
      PrintCountsAndChars(outputBlock, barrLE, 0, 8, u32LE)

   End Sub 'Main


   Public Shared Sub PrintCountsAndChars(ByVal outputBlock As System.Windows.Controls.TextBlock, ByVal bytes() As Byte, ByVal index As Integer, ByVal count As Integer, ByVal enc As Encoding)

      ' Display the name of the encoding used.
      outputBlock.Text += String.Format("{0,-25} :", enc.ToString())

      ' Display the exact character count.
      Dim iCC As Integer = enc.GetCharCount(bytes, index, count)
      outputBlock.Text += String.Format(" {0,-3}", iCC)

      ' Display the maximum character count.
      Dim iMCC As Integer = enc.GetMaxCharCount(count)
      outputBlock.Text += String.Format(" {0,-3} :", iMCC)

      ' Decode the bytes.
      Dim chars As Char() = enc.GetChars(bytes, index, count)

      ' The following is an alternative way to decode the bytes:
      ' NOTE: In VB.NET, arrays contain one extra element by default.
      '       The following line creates the array with the exact number of elements required.
      ' Dim chars(iCC - 1) As Char
      ' enc.GetChars( bytes, index, count, chars, 0 )

      ' Display the characters.
      outputBlock.Text &= chars & vbCrLf

   End Sub 'PrintCountsAndChars 

End Class 'SamplesEncoding


'This code produces the following output.  The question marks take the place of characters that cannot be displayed at the console.
'
'BE array with BE encoding : System.Text.UTF32Encoding : 2   6   :za
'LE array with LE encoding : System.Text.UTF32Encoding : 2   6   :za

using System;
using System.Text;

public class Example
{

   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {

      // Create two instances of UTF32Encoding: one with little-endian byte order and one with big-endian byte order.
      Encoding u32LE = Encoding.GetEncoding("utf-32");
      Encoding u32BE = Encoding.GetEncoding("utf-32BE");

      // Use a 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)
      String myStr = "za\u0306\u01FD\u03B2";

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

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

      // Get the char counts, decode eight bytes starting at index 0,
      // and print out the counts and the resulting bytes.
      outputBlock.Text += "BE array with BE encoding : ";
      PrintCountsAndChars(outputBlock, barrBE, 0, 8, u32BE);
      outputBlock.Text += "LE array with LE encoding : ";
      PrintCountsAndChars(outputBlock, barrLE, 0, 8, u32LE);

   }


   public static void PrintCountsAndChars(System.Windows.Controls.TextBlock outputBlock, byte[] bytes, int index, int count, Encoding enc)
   {

      // Display the name of the encoding used.
      outputBlock.Text += String.Format("{0,-25} :", enc.ToString());

      // Display the exact character count.
      int iCC = enc.GetCharCount(bytes, index, count);
      outputBlock.Text += String.Format(" {0,-3}", iCC);

      // Display the maximum character count.
      int iMCC = enc.GetMaxCharCount(count);
      outputBlock.Text += String.Format(" {0,-3} :", iMCC);

      // Decode the bytes and display the characters.
      char[] chars = enc.GetChars(bytes, index, count);

      // The following is an alternative way to decode the bytes:
      // char[] chars = new char[iCC];
      // enc.GetChars( bytes, index, count, chars, 0 );

      outputBlock.Text += chars + "\n";

   }

}


/* 
This code produces the following output.  The question marks take the place of characters that cannot be displayed at the console.

BE array with BE encoding : System.Text.UTF32Encoding : 2   6   :za
LE array with LE encoding : System.Text.UTF32Encoding : 2   6   :za

*/