Funções Dec2Hex e Hex2Dec
Aplica-se a:
Aplicativos Canvas Dataverse Plug-ins low-code Fluxos de desktop Aplicativos orientados a modelos Power Pages Power Platform CLI
Converta entre strings de texto hexadecimais e números.
Description
Use a função Dec2Hex para converter um número em uma string de texto hexadecimal. Dec2Hex emite os caracteres 0 a 9 e caracteres maiúsculos A a F; use a função Lower para converter o resultado para minúsculas, se desejar. Dec2Hex trunca o número de entrada para um número inteiro como se a função Trunc tivesse sido aplicada primeiro. Use Locais para preencher um número positivo com 0entrelinhamento (zeros) e limitar o comprimento da saída; Locais é ignorado se a entrada for negativa.
Use a função Hex2Dec para converter uma string de texto contendo dígitos hexadecimais (0 até 9 e A até F) para um número. Caracteres maiúsculos e minúsculos são aceitos. Não podem ser passados mais de 10 caracteres hexadecimais para Hex2Dec.
Ambas as funções funcionam com um número inteiro de 40 bits em complemento de dois. O intervalo de valores aceitos para ambas as funções é hexadecimal 8000000000 ou decimal -549755813888 até hexadecimal 7FFFFFFFF ou decimal 549755813887.
Se você passar um número único ou string de texto para essas funções, o valor de retorno será um resultado único. Se você passar uma tabela de coluna única, o valor retornado é uma tabela de resultados de coluna única, com um resultado para cada registro na tabela do argumento. Se você tiver uma tabela de várias colunas, é possível formatá-la como uma tabela de coluna única, como descrito em Trabalhando com tabelas.
Se o valor de entrada estiver fora do intervalo ou incluir caracteres hexadecimais inválidos, um erro ErrorKind.Numeric será retornado. Se a entrada for uma tabela de coluna única, o erro será incorporado na tabela de saída.
Sintaxe
Dec2Hex( Número [, Casas] )
- Número - Obrigatório. Número a ser convertido para hexadecimal.
- Locais - Opcional. O número de caracteres a serem usados se o número for positivo. Se Locais for omitido, Dec2Hex usa o número mínimo de caracteres necessários. Se esse parâmetro for fornecido e o resultado não couber no espaço fornecido, um erro ErrorKind.Numeric será retornado. Locais é ignorado se o número a ser convertido for negativo.
Hex2Dec( HexString )
- HexString - Obrigatório. Cadeia de caracteres de dígitos hexadecimais a serem convertidos em um número.
Exemplos
Uso básico de Hex2Dec
| Fórmula | Result |
|---|---|
Hex2Dec( "A5" ) |
165 |
Hex2Dec( "FFFFFFFF5B") |
-165 |
Hex2Dec( "c8d" ) |
3213 |
Hex2Dec( "fffffff373" ) |
-3213 |
Hex2Dec( "ffffffffff" ) |
-1 |
Hex2Dec( "ffffffffffff" ) |
error (out of range) |
Hex2Dec( "43j" ) |
error (invalid hexadecimal character) |
Hex2Dec( [ "A", "12", "FFFF" ] ) |
[ 10, 18, 65535 ] |
Hex2Dec( [ "3", "E", "I", "B" ] ) |
[ 3, 14, error (invalid hexadecimal character), 11 ] |
Uso básico de Dec2Hex
| Fórmula | Result |
|---|---|
Dec2Hex( 165 ) |
"A5" |
Dec2Hex( -165 ) |
"FFFFFFFF5B" |
Dec2Hex( 3213 ) |
"c8d" |
Dec2Hex( -3213 ) |
"FFFFFFF373" |
Dec2Hex( -1 ) |
"FFFFFFFFFF" |
Dec2Hex( 3.74 ) |
"3" |
Dec2Hex( -3.74 ) |
"FFFFFFFFFD" |
Dec2Hex( [ 10, 255, -16 ] ) |
[ "A", "FF", "FFFFFFFFF0" ] |
Dec2Hex( 1e45 ) |
error (out of range) |
Dec2Hex( [ 1, 1e-45, 1e45, 2 ] ) |
[ "1", "0", error (out of range), "2" ] |
Uso básico de Dec2Hex com argumento Locais
| Fórmula | Result |
|---|---|
Dec2Hex( 45780 ) |
"B2D4" |
Dec2Hex( 45780, 4 ) |
"B2D4" |
Dec2Hex( 45780, 5 ) |
"0B2D4" |
Dec2Hex( 45780, 6 ) |
"00B2D4" |
Dec2Hex( 45780, 3 ) |
error (not enough space) |
Dec2Hex( 45780, 11 ) |
error (out of range) |
Dec2Hex( -45780 ) |
"FFFFFF4D2C" |
Dec2Hex( -45780, 4 ) |
"FFFFFF4D2C" |
Dec2Hex( -45780, 6 ) |
"FFFFFF4D2C" |
Dec2Hex( -45780, 10 ) |
"FFFFFF4D2C" |
Dec2Hex( -45780, 11 ) |
error (out of range) |
Uso básico de Dec2Hex com tabelas de coluna única e argumento Locais
| Fórmula | Result |
|---|---|
Dec2Hex( [ 10, 255, -16 ], [ 1, 2, 3 ] ) |
[ "A", "FF", "FFFFFFFFF0" ] |
Dec2Hex( [ 10, 255, -16 ], 4 ) |
[ "000A", "00FF", "FFFFFFFFF0" ] |
Dec2Hex( 255, [0, 1, 2, 3] ) |
[ error (not enough space), error (not enough space), "FF", "0FF" ] |