Funções Dec2Hex e Hex2Dec
Aplica-se a:
Aplicações de tela Plug-ins low-code do Dataverse Fluxos de ambiente de trabalho Aplicações condicionadas por modelo Power Pages Power Platform CLI
Converta entre cadeias de texto hexadecimais e números.
Descrição
Utilize a função Dec2Hex para converter um número numa cadeia de texto hexadecimal.
A função Dec2Hex emite os carateres 0 a 9 e os carateres maiúsculos A a F; utilize a função Lower para converter o resultado em minúsculas se o pretender.
A função Dec2Hex trunca o número de entrada para um número inteiro como se a função Trunc tivesse sido aplicada primeiro. Utilize o argumento Places para preencher um número positivo com 0s (zeros) à esquerda e limitar o comprimento da saída; Places é ignorado se a entrada for negativa.
Utilize a função Hex2Dec para converter uma cadeia de texto com dígitos hexadecimais (0 a 9 e A a F) num número. Os carateres maiúsculos e minúsculos são aceites. Não é possível transmitir mais do que 10 carateres hexadecimais para Hex2Dec.
Ambas as funções funcionam com um número inteiro de 40 bits, complemento de dois. O intervalo de valores aceites para ambas as funções é hexadecimal 8000000000 ou decimal -549755813888 para hexadecimal 7FFFFFFFFF ou decimal 549755813887.
Se transmitir um único número ou cadeia de texto a estas funções, o valor devolvido será um único resultado. Se transmitir uma tabela de coluna única, o valor devolvido é uma tabela de coluna única de resultados, um resultado para cada registo na tabela do argumento. Se tiver uma tabela com várias colunas, pode formatá-las para uma tabela com uma única coluna, conforme descrito em trabalhar com tabelas.
Se o valor de entrada estiver fora do intervalo ou incluir carateres hexadecimais inválidos, é devolvido um erro ErrorKind.Numeric. Se a entrada foi uma tabela de coluna única, o erro é incorporado na tabela de saída.
Sintaxe
Dec2Hex( Número [, Places] )
- Número – Obrigatório. Número a converter em cadeia hexadecimal.
- Places – Opcional. O número de carateres a ser utilizado se o número for positivo. Se o argumento Places for omitido, Dec2Hex utiliza o número mínimo de carateres necessários. Se este parâmetro for fornecido e o resultado não couber no espaço fornecido, será devolvido um erro ErrorKind.Numeric. O argumento Places é ignorado se o número a converter for negativo.
Hex2Dec( HexString )
- HexString – Obrigatório. Cadeia de dígitos hexadecimais para converter num número.
Exemplos
Utilização básica de Hex2Dec
| Fórmula | Resultado |
|---|---|
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 ] |
Utilização básica de Dec2Hex
| Fórmula | Resultado |
|---|---|
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" ] |
Utilização básica de Dec2Hex com o argumento Places
| Fórmula | Resultado |
|---|---|
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) |
Utilização básica de Dec2Hex com tabelas de colunas únicas e o argumento Places
| Fórmula | Resultado |
|---|---|
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" ] |