Funcións Dec2Hex e Hex2Dec

Aplícase a: Aplicacións de lenzo Dataverse Complementos con pouco código Fluxos de escritorio Aplicacións baseadas en modelos Power Pages Power Platform CLI

Converte entre cadeas de texto hexadecimais e números.

Descripción

Use a función Dec2Hex para converter un número nunha cadea de texto hexadecimal. Dec2Hex emite os caracteres 0 a través de 9 e os caracteres en maiúsculas A a través de F; use a función Minúscula para converter o resultado en minúsculas se o desexa. Dec2Hex trunca o número de entrada a un número enteiro coma se a función Trunc se aplicase primeiro. Use Lugares para rellenar un número positivo con 0s principais (ceros) e limitar a lonxitude da saída; Lugares ignorarase se a entrada é negativa.

Use a función Hex2Dec para converter unha cadea de texto que conteña díxitos hexadecimais (0 a 9 e A a través de F) a un número. Admítense caracteres en maiúsculas e minúsculas. Non se poden pasar máis de 10 caracteres hexadecimais a Hex2Dec.

Ambas funcións funcionan cun número enteiro de 40 bits, complemento de dous. O intervalo de valores aceptados para ambas as funcións é hexadecimal 8000000000 ou decimal -549755813888 a hexadecimal 7FFFFFFFFF ou decimal 549755813887.

Se pasa un único número ou cadea de texto a estas funcións, o valor de retorno é un único resultado. Se pasa unha táboa dunha única columna o valor de retorno é unha táboa de resultados dunha soa columna, un resultado para cada rexistro da táboa de argumentos. Se ten unha táboa con varias columnas, pode plasmala nunha táboa dunha única columna, como traballar con táboas describe.

Se o valor de entrada está fóra do intervalo ou inclúe caracteres hexadecimais non válidos, devólvese un erro ErrorKind.Numeric . Se a entrada foi unha táboa dunha soa columna, o erro está incrustado na táboa de saída.

Sintaxe

Dec2Hex( Número [, Lugares] )

• Number: Obrigatorio. Número a converter en hexadecimal.
• Lugares - Opcional. O número de caracteres a utilizar se o número é positivo. Se se omite Lugares , Dec2Hex usa o número mínimo de caracteres necesarios. Se se proporciona este parámetro e o resultado non encaixa no espazo proporcionado, devólvese un erro ErrorKind.Numeric . Lugares ignorarase se o número a converter é negativo.

Hex2Dec( HexString )

• HexString : é necesario. Cadena de díxitos hexadecimais para converter nun número.

Exemplos

Uso básico 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 ]

Uso básico 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" ]

Uso básico de Dec2Hex co 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)

Uso básico de Dec2Hex con táboas dunha soa columna e 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" ]