BitConverter::ToInt16 Method (array<Byte>^, Int32)
Returns a 16-bit signed integer 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 of bytes.
- startIndex
-
Type:
System::Int32
The starting position within value.
Return Value
Type: System::Int16A 16-bit signed integer formed by two bytes beginning at startIndex.
| 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 ToInt16 method converts the bytes from index startIndex to startIndex + 1 to an Int16 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 Int16 values with the ToInt16 method.
// Example of the BitConverter::ToInt16 method. using namespace System; // Convert two byte array elements to a short and display it. void BAToInt16( array<unsigned char>^bytes, int index ) { short value = BitConverter::ToInt16( bytes, index ); Console::WriteLine( "{0,5}{1,17}{2,10}", index, BitConverter::ToString( bytes, index, 2 ), value ); } int main() { array<unsigned char>^byteArray = {15,0,0,128,16,39,240,216,241,255,127}; Console::WriteLine( "This example of the BitConverter::ToInt16( unsigned " "char[ ], int ) \nmethod generates the following output. It " "converts elements of a \nbyte array to short values.\n" ); Console::WriteLine( "initial byte array" ); Console::WriteLine( "------------------" ); Console::WriteLine( BitConverter::ToString( byteArray ) ); Console::WriteLine(); Console::WriteLine( "{0,5}{1,17}{2,10}", "index", "array elements", "short" ); Console::WriteLine( "{0,5}{1,17}{2,10}", "-----", "--------------", "-----" ); // Convert byte array elements to short values. BAToInt16( byteArray, 1 ); BAToInt16( byteArray, 0 ); BAToInt16( byteArray, 8 ); BAToInt16( byteArray, 4 ); BAToInt16( byteArray, 6 ); BAToInt16( byteArray, 9 ); BAToInt16( byteArray, 2 ); } /* This example of the BitConverter::ToInt16( unsigned char[ ], int ) method generates the following output. It converts elements of a byte array to short values. initial byte array ------------------ 0F-00-00-80-10-27-F0-D8-F1-FF-7F index array elements short ----- -------------- ----- 1 00-00 0 0 0F-00 15 8 F1-FF -15 4 10-27 10000 6 F0-D8 -10000 9 FF-7F 32767 2 00-80 -32768 */
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