BitConverter.ToChar Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| ToChar(Byte[], Int32) |
Retorna um caractere Unicode convertido dos dois bytes em uma posição especificada em uma matriz de bytes. |
| ToChar(ReadOnlySpan<Byte>) |
Converte um intervalo de bytes somente leitura em um caractere. |
ToChar(Byte[], Int32)
- Origem:
- BitConverter.cs
- Origem:
- BitConverter.cs
- Origem:
- BitConverter.cs
Retorna um caractere Unicode convertido dos dois bytes em uma posição especificada em uma matriz de bytes.
public:
static char ToChar(cli::array <System::Byte> ^ value, int startIndex);public static char ToChar (byte[] value, int startIndex);static member ToChar : byte[] * int -> charPublic Shared Function ToChar (value As Byte(), startIndex As Integer) As CharParâmetros
- value
- Byte[]
Uma matriz que inclui os dois bytes a serem convertidos.
- startIndex
- Int32
A posição inicial dentro de value.
Retornos
O caractere formado por dois bytes começando em startIndex.
Exceções
startIndex é igual ao comprimento de value menos 1.
value é null.
startIndex é menor que zero ou maior que o tamanho de value menos 1.
Exemplos
O exemplo de código a seguir converte elementos de Byte matrizes em Char valores (caracteres Unicode) com o ToChar método .
// 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 €
*/
// Example of the BitConverter.ToChar method.
using System;
class BytesToCharDemo
{
const string formatter = "{0,5}{1,17}{2,8}";
// Convert two byte array elements to a char and display it.
public static void BAToChar( byte[] bytes, int index )
{
char value = BitConverter.ToChar( bytes, index );
Console.WriteLine( formatter, index,
BitConverter.ToString( bytes, index, 2 ), value );
}
public static void Main( )
{
byte[] 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( byte[ ], " +
"int ) \nmethod generates the following output. It " +
"converts \nelements of a byte array to char values.\n" );
Console.WriteLine( "initial byte array" );
Console.WriteLine( "------------------" );
Console.WriteLine( BitConverter.ToString( byteArray ) );
Console.WriteLine( );
Console.WriteLine( formatter, "index", "array elements", "char" );
Console.WriteLine( formatter, "-----", "--------------", "----" );
// Convert byte array elements to char 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(byte[ ], int)
method generates the following output. It converts
elements of a byte array to char values.
initial byte array
------------------
20-00-00-2A-00-41-00-7D-00-C5-00-A8-03-29-04-AC-20
index array elements char
----- -------------- ----
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 €
*/
open System
let print obj1 obj2 obj3 = printfn $"{obj1,5}{obj2,17}{obj3,8}"
// Convert two byte array elements to a char and display it.
let BAToChar bytes index =
let value = BitConverter.ToChar(bytes, index)
print index (BitConverter.ToString(bytes, index, 2)) value
let byteArray =
[| 32uy; 0uy; 0uy; 42uy; 0uy; 65uy; 0uy; 125uy; 0uy
197uy; 0uy; 168uy; 3uy; 41uy; 4uy; 172uy; 32uy |]
printfn "This example of the BitConverter.ToChar(byte [], int) \nmethod generates the following output. It converts \nelements of a byte array to char values.\n"
printfn "initial byte array"
printfn "------------------"
printfn $"{BitConverter.ToString byteArray}\n"
print "index" "array elements" "char"
print "-----" "--------------" "----"
// Convert byte array elements to char 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(byte [], int)
// method generates the following output. It converts
// elements of a byte array to char values.
//
// initial byte array
// ------------------
// 20-00-00-2A-00-41-00-7D-00-C5-00-A8-03-29-04-AC-20
//
// index array elements char
// ----- -------------- ----
// 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 €
' Example of the BitConverter.ToChar method.
Module BytesToCharDemo
Const formatter As String = "{0,5}{1,17}{2,8}"
' Convert two Byte array elements to a Char and display it.
Sub BAToChar( bytes( ) As Byte, index As Integer )
Dim value As Char = BitConverter.ToChar( bytes, index )
Console.WriteLine( formatter, index, _
BitConverter.ToString( bytes, index, 2 ), value )
End Sub
Sub Main( )
Dim byteArray as Byte( ) = { _
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( Byte( ), " & _
"Integer ) " & vbCrLf & "method generates the " & _
"following output. It converts elements " & vbCrLf & _
"of a Byte array to Char values." & vbCrLf )
Console.WriteLine( "initial Byte array" )
Console.WriteLine( "------------------" )
Console.WriteLine( BitConverter.ToString( byteArray ) )
Console.WriteLine( )
Console.WriteLine( formatter, "index", "array elements", "Char" )
Console.WriteLine( formatter, "-----", "--------------", "----" )
' Convert Byte array elements to Char 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 )
End Sub
End Module
' This example of the BitConverter.ToChar( Byte( ), Integer )
' method generates the following output. It converts elements
' of a Byte array to Char values.
'
' initial Byte array
' ------------------
' 20-00-00-2A-00-41-00-7D-00-C5-00-A8-03-29-04-AC-20
'
' index array elements Char
' ----- -------------- ----
' 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 €
Comentários
O ToChar método converte os bytes do índice startIndex em startIndex + 1 em um Char valor. A ordem de bytes na matriz deve refletir a endianidade da arquitetura do sistema de computador. Para obter mais informações, consulte a seção Comentários do BitConverter tópico de classe.
Confira também
Aplica-se a
ToChar(ReadOnlySpan<Byte>)
- Origem:
- BitConverter.cs
- Origem:
- BitConverter.cs
- Origem:
- BitConverter.cs
Converte um intervalo de bytes somente leitura em um caractere.
public:
static char ToChar(ReadOnlySpan<System::Byte> value);public static char ToChar (ReadOnlySpan<byte> value);static member ToChar : ReadOnlySpan<byte> -> charPublic Shared Function ToChar (value As ReadOnlySpan(Of Byte)) As CharParâmetros
- value
- ReadOnlySpan<Byte>
Um intervalo somente leitura que contém os bytes a serem convertidos.
Retornos
Um caractere que representa os bytes convertidos.
Exceções
O tamanho de value é menor que o tamanho de um Char.
Aplica-se a
Colaborar conosco no GitHub
A fonte deste conteúdo pode ser encontrada no GitHub, onde você também pode criar e revisar problemas e solicitações de pull. Para obter mais informações, confira o nosso guia para colaboradores.
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de