Encoding.GetCharCount Method (Byte[])
Assembly: mscorlib (in mscorlib.dll)
To calculate the exact array size required by GetChars to store the resulting characters, use GetCharCount. To calculate the maximum array size, use GetMaxCharCount. The GetCharCount method generally allows you to allocate less memory, whereas the GetMaxCharCount method generally executes faster.
The following code example encodes a string into an array of bytes, and then decodes the bytes into an array of characters.
using namespace System; using namespace System::Text; void PrintCountsAndChars( array<Byte>^bytes, Encoding^ enc ); int main() { // 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. array<Byte>^barrBE = gcnew array<Byte>(u32BE->GetByteCount( myStr )); u32BE->GetBytes( myStr, 0, myStr->Length, barrBE, 0 ); // Encode the string using the little-endian byte order. array<Byte>^barrLE = gcnew array<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 ); } void PrintCountsAndChars( array<Byte>^bytes, Encoding^ enc ) { // Display the name of the encoding used. Console::Write( "{0,-25} :", enc ); // 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. array<Char>^chars = enc->GetChars( bytes ); Console::WriteLine( chars ); } /* 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 : 5 12 :za?? LE array with LE encoding : System.Text.UTF32Encoding : 5 12 :za?? */
import System.*;
import System.Text.*;
public class SamplesEncoding
{
public static void main(String[] args)
{
// 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.
ubyte barrBE[] = new ubyte[u32BE.GetByteCount(myStr)];
u32BE.GetBytes(myStr, 0, myStr.get_Length(), barrBE, 0);
// Encode the string using the little-endian byte order.
ubyte barrLE[] = new ubyte[u32LE.GetByteCount(myStr)];
u32LE.GetBytes(myStr, 0, myStr.get_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);
} //main
public static void PrintCountsAndChars(ubyte 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}", String.valueOf(iCC));
// Display the maximum character count.
int iMCC = enc.GetMaxCharCount(bytes.length);
Console.Write(" {0,-3} :", String.valueOf(iMCC));
// Decode the bytes and display the characters.
char chars[] = enc.GetChars(bytes);
Console.WriteLine(chars);
} //PrintCountsAndChars
} //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 : 5 12 :za??
LE array with LE encoding : System.Text.UTF32Encoding : 5 12 :za??
*/
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.