Funkcje Dec2Hex i Hex2Dec

Dotyczy: Aplikacje kanwyWtyczki Dataverse niskokodowe Przepływy pulpitu Aplikacje oparte na modelu Interfejs Power Pages Power Platform wiersza polecenia

Konwertowanie między szesnastkowymi ciągami tekstowymi i cyframi.

Popis

Użyj funkcji Dec2Hex do przekonwertowania liczby na szesnastkową ciąg tekstowy. Dec2Hex emituje znaki 0 przez 9 i wielkie litery A F; użyj funkcji Lower , aby przekonwertować wynik na małe litery, jeśli jest to pożądane. Dec2Hex obcina liczbę wejściową do liczby całkowitej, tak jakby funkcja Trunc została zastosowana jako pierwsza. Użyj Miejsca, aby wykorzystać liczbę dodatnią 0 (zera) i ograniczyć długość wyjściową; Miejsca są ignorowane, jeśli wartość wejściowa jest ujemna.

Użyj funkcji Hex2Dec do przekonwertowania ciągu tekstowego zawierającego cyfry szesnastkowe (0 przez 9 i A przez F) na liczbę. Znaki o wielkiej i małej literze są akceptowane. Do Hex2Dec nie można przekazać więcej niż 10 znaków szesnastkowych.

Obie te funkcje działają z 40-bitową liczbą uzupełnianą o dwa. Zakres zaakceptowanych wartości dla obu funkcji to szesnastkowy 8000000000 lub dziesiętny -549755813888 do szesnastkowego 7FFFFFFFFF lub dziesiętnego 549755813887.

W przypadku przekazania do tych funkcji pojedynczej liczby lub ciąg tekstowy wartość zwracana jest pojedynczym wynikiem. Jeśli zostanie przekazana jednokolumnowa tabela, zwracana wartość będzie jednokolumnową tabelą wyników, w której poszczególne wyniki będą odpowiadały każdemu rekordowi w tabeli argumentów. Tabelę wielokolumnową można przekształcić w tabelę jednokolumnową, postępując zgodnie z opisem z sekcji praca z tabelami.

Jeśli wartość wejściowa jest poza zakresem lub zawiera nieprawidłowe znaki szesnastkowymi, jest zwracany błąd ErrorKind.Numeric. Jeśli informacja wejściowa stanowiła tabelę zawierającą jedną kolumnę, błąd jest osadzony w tabeli wyjściowej.

Składnia

Dec2Hex( liczba [; miejsca] )

• Liczba- Wymagane . Liczba do przekonwertowania na szesnastkową.
• Miejsca - Opcjonalnie. Liczba znaków, których należy używać, jeśli liczba jest dodatnia. W przypadku pominięcia wartości Miejsca wartość Dec2Hex używa minimalnej wymaganej liczby znaków. Jeśli parametr jest podany, a wynik nie pasuje do podanego miejsca, jest zwracany błąd ErrorKind.Numeric. Miejsce jest ignorowane, jeśli liczba do przekonwertowania jest ujemna.

Hex2Dec( Ciąg szesnastkowy)

• HexString - wymagane. Ciąg cyfr szesnastych do przekonwertowania na liczbę.

Przykłady

Podstawowe użycie w programie Hex2Dec

Formuła	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 ]

Podstawowe użycie w programie Dec2Hex

Formuła	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" ]

Podstawowe użycie argumentu Dec2Hex z argumentem Miejsca

Formuła	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)

Podstawowe użycie funkcji Dec2Hex z tabelami jedno kolumnowymi i argumentem Miejsca

Formuła	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" ]