Funkce Dec2Hex a Hex2Dec

Platí pro: Aplikace plátna Moduly plug-in Dataverse s minimálním psaním kódu Desktopové toky Modelem řízené aplikace Power Pages Rozhraní příkazového řádku Power Platform

Převod mezi hexadecimálními textovými řetězci a čísly.

Description

Pomocí funkce Dec2Hex převeďte číslo na hexadecimální textový řetězec. Dec2Hex vydává znaky 0 až 9 a velká písmena A až F; použijte funkci Lower k převedení výsledku na malá písmena, pokud si to přejete. Dec2Hex zkrátí vstupní číslo na celé číslo, jako kdyby byla nejprve použita funkce Trunc. Pomocí funkce Places doplňte kladné číslo úvodními 0 (nulami) a omezte délku výstupu; Places je ignorováno, pokud je vstup záporný.

Pomocí funkce Hex2Dec převeďte textový řetězec obsahující hexadecimální číslice (0 až 9 a A až F) na číslo. Jsou přijímána velká a malá písmena. Do Hex2Dec nelze předat více než 10 hexadecimálních znaků.

Obě tyto funkce pracují s 40bitovým, dvojkovým doplňkem, celým číslem. Rozsah akceptovaných hodnot pro obě funkce je hexadecimální 8000000000 nebo desítkový −549755813888 až šestnáctkový 7FFFFFFFFF nebo desítkový 549755813887.

Pokud těmto funkcím předáte jedno číslo nebo textový řetězec, bude vrácenou hodnotou jeden výsledek. Pokud použijete tabulku s jedním sloupcem, bude vrácenou hodnotou tabulka výsledků s jedním sloupcem, přičemž každému záznamu v tabulce argumentu bude odpovídat jeden výsledek. Pokud máte tabulku s více sloupci, převeďte ji na tabulku s jedním sloupcem, jak je popsáno v části popisující práci s tabulkami.

Pokud je vstupní hodnota mimo rozsah nebo obsahuje neplatné hexadecimální znaky, vrátí se chyba ErrorKind.Numeric. Pokud byla vstupem tabulka s jedním sloupcem, chyba je vložena do výstupní tabulky.

Syntaxe

Dec2Hex( Number [, Places] )

• Number – povinné. Číslo, které se má převést na šestnáctkové.
• Places – volitelné. Počet znaků, které se mají použít, pokud je číslo kladné. Pokud je vynecháno Places, Dec2Hex použije minimální nutný počet znaků. Pokud je tento parametr zadán a výsledek se nevejde do poskytnutého prostoru, vrátí se chyba ErrorKind.Numeric. Places je ignorováno, pokud je číslo k převodu záporné.

Hex2Dec( HexString )

• HexString – povinné. Řetězec hexadecimálních číslic pro převod na číslo.

Příklady

Základní použití Hex2Dec

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

Základní použití Dec2Hex

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

Základní použití Dec2Hex s argumentem Places

Vzorec	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)

Základní použití Dec2Hex s jednosloupcovými tabulkami a argumentem Places

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