BitConverter.ToInt16 Method
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
| ToInt16(Byte[], Int32) |
Returns a 16-bit signed integer converted from two bytes at a specified position in a byte array. |
| ToInt16(ReadOnlySpan<Byte>) |
Converts a read-only byte span into a 16-bit signed integer. |
- Source:
- BitConverter.cs
- Source:
- BitConverter.cs
- Source:
- BitConverter.cs
Returns a 16-bit signed integer converted from two bytes at a specified position in a byte array.
public:
static short ToInt16(cli::array <System::Byte> ^ value, int startIndex);C#
public static short ToInt16(byte[] value, int startIndex);static member ToInt16 : byte[] * int -> int16Public Shared Function ToInt16 (value As Byte(), startIndex As Integer) As ShortParameters
- value
- Byte[]
An array of bytes that includes the two bytes to convert.
- startIndex
- Int32
The starting position within value.
Returns
A 16-bit signed integer formed by two bytes beginning at startIndex.
Exceptions
startIndex equals the length of value minus 1.
value is null.
startIndex is less than zero or greater than the length of value minus 1.
Examples
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
*/
C#
// Example of the BitConverter.ToInt16 method.
using System;
class BytesToInt16Demo
{
const string formatter = "{0,5}{1,17}{2,10}";
// Convert two byte array elements to a short and display it.
public static void BAToInt16( byte[ ] bytes, int index )
{
short value = BitConverter.ToInt16( bytes, index );
Console.WriteLine( formatter, index,
BitConverter.ToString( bytes, index, 2 ), value );
}
public static void Main( )
{
byte[ ] byteArray =
{ 15, 0, 0, 128, 16, 39, 240, 216, 241, 255, 127 };
Console.WriteLine(
"This example of the BitConverter.ToInt16( byte[ ], " +
"int ) \nmethod generates the following output. It " +
"converts elements \nof a byte array to short values.\n" );
Console.WriteLine( "initial byte array" );
Console.WriteLine( "------------------" );
Console.WriteLine( BitConverter.ToString( byteArray ) );
Console.WriteLine( );
Console.WriteLine( formatter, "index", "array elements", "short" );
Console.WriteLine( formatter, "-----", "--------------", "-----" );
// 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( byte[ ], 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
*/
open System
let print obj1 obj2 obj3 = printfn $"{obj1,5}{obj2,17}{obj3,10}"
// Convert two byte array elements to a short and display it.
let BAToInt16 bytes index =
let value = BitConverter.ToInt16(bytes, index)
print index (BitConverter.ToString(bytes, index, 2)) value
let byteArray =
[| 15uy; 0uy; 0uy; 128uy; 16uy; 39uy; 240uy; 216uy; 241uy; 255uy; 127uy |]
printfn "This example of the BitConverter.ToInt16(byte [], int) \nmethod generates the following output. It converts elements \nof a byte array to short values.\n"
printfn "initial byte array"
printfn "------------------"
printfn $"{BitConverter.ToString byteArray}\n"
print "index" "array elements" "short"
print "-----" "--------------" "-----"
// 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(byte [], 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
' Example of the BitConverter.ToInt16 method.
Module BytesToInt16Demo
Const formatter As String = "{0,5}{1,17}{2,10}"
' Convert two Byte array elements to a Short and display it.
Sub BAToInt16( bytes( ) As Byte, index As Integer )
Dim value As Short = BitConverter.ToInt16( bytes, index )
Console.WriteLine( formatter, index, _
BitConverter.ToString( bytes, index, 2 ), value )
End Sub
Sub Main( )
Dim byteArray as Byte( ) = { _
15, 0, 0, 128, 16, 39, 240, 216, 241, 255, 127 }
Console.WriteLine( _
"This example of the BitConverter.ToInt16( Byte( ), " & _
"Integer ) " & vbCrLf & "method generates the " & _
"following output. It converts elements " & vbCrLf & _
"of a Byte array to Short values." & vbCrLf )
Console.WriteLine( "initial Byte array" )
Console.WriteLine( "------------------" )
Console.WriteLine( BitConverter.ToString( byteArray ) )
Console.WriteLine( )
Console.WriteLine( formatter, "index", "array elements", "Short" )
Console.WriteLine( formatter, "-----", "--------------", "-----" )
' 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 )
End Sub
End Module
' This example of the BitConverter.ToInt16( Byte( ), Integer )
' 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
Remarks
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.
See also
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
- Source:
- BitConverter.cs
- Source:
- BitConverter.cs
- Source:
- BitConverter.cs
Converts a read-only byte span into a 16-bit signed integer.
public:
static short ToInt16(ReadOnlySpan<System::Byte> value);C#
public static short ToInt16(ReadOnlySpan<byte> value);static member ToInt16 : ReadOnlySpan<byte> -> int16Public Shared Function ToInt16 (value As ReadOnlySpan(Of Byte)) As ShortParameters
- value
- ReadOnlySpan<Byte>
A read-only span containing the bytes to convert.
Returns
A 16-bit signed integer representing the converted bytes.
Exceptions
The length of value is less than 2.
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Standard | 2.1 |
Collaborate with us on GitHub
The source for this content can be found on GitHub, where you can also create and review issues and pull requests. For more information, see our contributor guide.
.NET feedback
.NET is an open source project. Select a link to provide feedback: