Share via

Funkcje Dec2Hex i Hex2Dec

  • Artykuł

Dotyczy: Aplikacje oparte na kanwie wtyczki low-code Dataverse Przepływy pulpitu Aplikacje oparte na modelach Power Platform CLI

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

Popis

Użyj funkcji Dec2Hex do przekonwertowania liczby na szesnastkową ciąg tekstowy. Dec2Hex tworzy znaki 0 poprzez 9 i wielkie litery A poprzez F; użyj funkcji Małe, by przekształcić wynik na małe litery, jeśli to konieczne. Dec2Hex obcina liczbę wejściową, tak jak w przypadku najpierw zastosowania funkcji Obcięte. 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( Numer [, Miejsca] )

  • Number — wymagane. Liczba do przekonwertowania na szesnastkową.
  • Miejsca — opcjonalne. 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. Miejsca są ignorowane, jeśli liczba do przekonwertowania jest ujemna.

Hex2Dec( HexString )

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