BitConverter.ToInt16 Método
Definição
Sobrecargas
ToInt16(ReadOnlySpan<Byte>) |
Converte um intervalo de bytes somente leitura em um inteiro com sinal de 16 bits.Converts a read-only byte span into a 16-bit signed integer. |
ToInt16(Byte[], Int32) |
Retorna um inteiro com sinal de 16 bits convertido de dois bytes em uma posição especificada em uma matriz de bytes.Returns a 16-bit signed integer converted from two bytes at a specified position in a byte array. |
ToInt16(ReadOnlySpan<Byte>)
Converte um intervalo de bytes somente leitura em um inteiro com sinal de 16 bits.Converts a read-only byte span into a 16-bit signed integer.
public:
static short ToInt16(ReadOnlySpan<System::Byte> value);
public static short ToInt16 (ReadOnlySpan<byte> value);
static member ToInt16 : ReadOnlySpan<byte> -> int16
Public Shared Function ToInt16 (value As ReadOnlySpan(Of Byte)) As Short
Parâmetros
- value
- ReadOnlySpan<Byte>
Um intervalo somente leitura que contém os bytes a serem convertidos.A read-only span containing the bytes to convert.
Retornos
Um inteiro com sinal de 16 bits que representa os bytes convertidos.A 16-bit signed integer representing the converted bytes.
Exceções
O tamanho de value
é menor que 2.The length of value
is less than 2.
ToInt16(Byte[], Int32)
Retorna um inteiro com sinal de 16 bits convertido de dois bytes em uma posição especificada em uma matriz de bytes.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);
public static short ToInt16 (byte[] value, int startIndex);
static member ToInt16 : byte[] * int -> int16
Public Shared Function ToInt16 (value As Byte(), startIndex As Integer) As Short
Parâmetros
- value
- Byte[]
Uma matriz de bytes.An array of bytes.
- startIndex
- Int32
A posição inicial dentro de value
.The starting position within value
.
Retornos
Um inteiro com sinal de 16 bits formado por dois bytes, começando em startIndex
.A 16-bit signed integer formed by two bytes beginning at startIndex
.
Exceções
startIndex
é igual ao comprimento de value
menos 1.startIndex
equals the length of value
minus 1.
value
é null
.value
is null
.
startIndex
é menor que zero ou maior que o tamanho de value
menos 1.startIndex
is less than zero or greater than the length of value
minus 1.
Exemplos
O exemplo de código a seguir converte elementos de matrizes Byte em valores Int16 com o método ToInt16
.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
*/
// 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
*/
' 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
Comentários
O método ToInt16 converte os bytes do índice startIndex
em startIndex
+ 1 em um valor Int16.The ToInt16 method converts the bytes from index startIndex
to startIndex
+ 1 to an Int16 value. A ordem dos bytes na matriz deve refletir a endian da arquitetura do sistema do computador; para obter mais informações, consulte a seção comentários do tópico da classe BitConverter.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.