BitConverter::ToChar Method (array<Byte>^, Int32)
.NET Framework (current version)
Returns a Unicode character converted from two bytes at a specified position in a byte array.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- value
-
Type:
array<System::Byte>^
An array.
- startIndex
-
Type:
System::Int32
The starting position within value.
| Exception | Condition |
|---|---|
| ArgumentException | startIndex equals the length of value minus 1. |
| ArgumentNullException | value is null. |
| ArgumentOutOfRangeException | startIndex is less than zero or greater than the length of value minus 1. |
The ToChar method converts the bytes from index startIndex to startIndex + 1 to a Char value. The order of bytes in the array must reflect the endianness of the computer system's architecture; for more information, see the Remarks section of the BitConverter class topic.
The following code example converts elements of Byte arrays to Char values (Unicode characters) with the ToChar method.
// Example of the BitConverter::ToChar method. using namespace System; // Convert two byte array elements to a __wchar_t and display it. void BAToChar( array<unsigned char>^bytes, int index ) { __wchar_t value = BitConverter::ToChar( bytes, index ); Console::WriteLine( "{0,5}{1,17}{2,11}", index, BitConverter::ToString( bytes, index, 2 ), value ); } int main() { array<unsigned char>^byteArray = {32,0,0,42,0,65,0,125,0,197,0,168,3,41,4,172,32}; Console::WriteLine( "This example of the BitConverter::ToChar( unsigned " "char[ ], int ) \nmethod generates the following output. It " "converts elements of a \nbyte array to __wchar_t values.\n" ); Console::WriteLine( "initial unsigned char array" ); Console::WriteLine( "---------------------------" ); Console::WriteLine( BitConverter::ToString( byteArray ) ); Console::WriteLine(); Console::WriteLine( "{0,5}{1,17}{2,11}", "index", "array elements", "__wchar_t" ); Console::WriteLine( "{0,5}{1,17}{2,11}", "-----", "--------------", "---------" ); // Convert byte array elements to __wchar_t values. BAToChar( byteArray, 0 ); BAToChar( byteArray, 1 ); BAToChar( byteArray, 3 ); BAToChar( byteArray, 5 ); BAToChar( byteArray, 7 ); BAToChar( byteArray, 9 ); BAToChar( byteArray, 11 ); BAToChar( byteArray, 13 ); BAToChar( byteArray, 15 ); } /* This example of the BitConverter::ToChar( unsigned char[ ], int ) method generates the following output. It converts elements of a byte array to __wchar_t values. initial unsigned char array --------------------------- 20-00-00-2A-00-41-00-7D-00-C5-00-A8-03-29-04-AC-20 index array elements __wchar_t ----- -------------- --------- 0 20-00 1 00-00 3 2A-00 * 5 41-00 A 7 7D-00 } 9 C5-00 � 11 A8-03 ? 13 29-04 ? 15 AC-20 ? */
Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Show: