Funciones Dec2Hex y Hex2Dec

Se aplica a: Aplicaciones de lienzo Complementos con poco código de Dataverse Flujos de escritorio Aplicaciones basadas en modelos Power Pages Power Platform CLI

Convierte entre cadenas de texto hexadecimales y números.

Description

Use la función Dec2Hex para convertir un número en una cadena de texto hexadecimal. Dec2Hex emite los caracteres 0 hasta 9 y caracteres en mayúsculas A hasta F; utilice la función Lower para convertir el resultado a minúsculas si lo desea. Dec2Hex trunca el número de entrada a un número entero como si la función Trunc se hubiera aplicado primero. Utilice Places para rellenar un número positivo con 0 (ceros) iniciales y limite la longitud de la salida; Places se ignora si la entrada es negativa.

Utilice la función Hex2Dec para convertir una cadena de texto que contenga dígitos hexadecimales (0 hasta 9 y A hasta F) a un número. Se aceptan caracteres en mayúsculas y minúsculas. No se pueden pasar más de 10 caracteres hexadecimales a Hex2Dec.

Ambas funciones funcionan con un número entero de 40 bits, en complemento a dos. El rango de valores aceptados para ambas funciones es hexadecimal 8000000000 o decimal -549755813888 a hexadecimal 7FFFFFFFFF o decimal 549755813887.

Si pasa un solo número o cadena de texto a estas funciones, el valor que se devuelve es un resultado único. Si pasa una tabla de una sola columna, el valor que se muestra es una tabla de resultados de una sola columna, un resultado para cada registro en la tabla del argumento. Si tiene una tabla con varias columnas, puede convertirla en una tabla de una sola columna, como se describe en cómo trabajar con tablas.

Si el valor de entrada está fuera de rango o incluye caracteres hexadecimales no válidos, se devuelve un error ErrorKind.Numeric. Si la entrada fue una tabla de una sola columna, el error se incrusta en la tabla de salida.

Sintaxis

Dec2Hex( Number [, Places] )

• Number (obligatorio). Número a convertir a hexadecimal.
• Places: optional. El número de caracteres que se utilizarán si el número es positivo. Si se omite Places, Dec2Hex utiliza el número mínimo de caracteres necesarios. Si se proporciona este parámetro y el resultado no cabe en el espacio proporcionado, se devuelve un error ErrorKind.Numeric. Places se ignora si el número a convertir es negativo.

Hex2Dec( HexString )

• HexString: obligatoria. Cadena de dígitos hexadecimales para convertir a un número.

Ejemplos

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 con el argumento Places

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 con tablas de una sola columna y argumento Places

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" ]