Funções Dec2Hex e Hex2Dec

Aplica-se a: Aplicativos de tela Plug-ins low-code do Dataverse Fluxos da área de trabalho Aplicativos baseados em modelo 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 até 9 e caracteres maiúsculos A até F; use a função Lower para converter o resultado em 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 [, Locais] )

• Number - 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. Places será 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" ]