UTF8Encoding.GetEncoder Method

Return Value

Type: System.Text.Encoder
An object that converts a sequence of Unicode characters into a UTF-8 encoded sequence of bytes.

Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class Example

   Public Shared Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)
      'Characters:
      ' ChrW(97) = a
      ' ChrW(98) = b
      ' ChrW(99) = c
      ' ChrW(768) = `
      ' ChrW(41120) = valid unicode code point, but not a character
      Dim chars() As Char = {ChrW(97), ChrW(98), ChrW(99), ChrW(768), ChrW(41120)}
      Dim bytes() As Byte

      Dim utf8Encoder As Encoder = Encoding.UTF8.GetEncoder()

      Dim byteCount As Integer = utf8Encoder.GetByteCount(chars, 2, 3, True)
      bytes = New Byte(byteCount - 1) {}
      Dim bytesEncodedCount As Integer = utf8Encoder.GetBytes( _
          chars, 2, 3, bytes, 0, True _
      )

      outputBlock.Text += String.Format("{0} bytes used to encode characters.", bytesEncodedCount) & vbCrLf

      outputBlock.Text &= "Encoded bytes: "
      Dim b As Byte
      For Each b In bytes
         outputBlock.Text += String.Format("[{0}]", b)
      Next b
      outputBlock.Text &= vbCrLf
   End Sub 'Main
End Class 'UTF8EncodingExample

using System;
using System.Text;

class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      Char[] chars = new Char[] { 'a', 'b', 'c', '\u0300', '\ua0a0' };
      Byte[] bytes;

      Encoder utf8Encoder = Encoding.UTF8.GetEncoder();

      int byteCount = utf8Encoder.GetByteCount(chars, 2, 3, true);
      bytes = new Byte[byteCount];
      int bytesEncodedCount = utf8Encoder.GetBytes(chars, 2, 3, bytes, 0, true);

      outputBlock.Text += String.Format(
          "{0} bytes used to encode characters.", bytesEncodedCount
      ) + "\n";

      outputBlock.Text += "Encoded bytes: ";
      foreach (Byte b in bytes)
      {
         outputBlock.Text += String.Format("[{0}]", b);
      }
      outputBlock.Text += "\n";
   }
}