Dec2Hex 和 Hex2Dec 函式

發行項
06/10/2024

適用於： 畫布應用程式 Dataverse 低程式碼外掛程式桌面流程模型導向應用程式 Power Pages Power Platform CLI

在十六進位文字字串和數字之間進行轉換。

Description

使用 Dec2Hex 函式將數字轉換為十六進位文字字串。 Dec2Hex 發出字元 0 到 9 以及大寫字元 A 到 F；如果需要，請使用 Lower 函式將結果轉換為小寫。 Dec2Hex 將輸入數字截斷為整數，就像先套用了 Trunc 函式一樣。使用 Places 用前導 0 (零) 填滿正數並限制輸出的長度；如果輸入為負數，將忽略 Places。

使用 Hex2Dec 函式轉換包含十六進位數字的文字字串 (0 到 9 和 A 到 F) 轉換為數字。接受大寫和小寫字元。不能將超過 10 個十六進位字元傳遞給 Hex2Dec。

這兩個函式都使用 40 位元二進位補碼整數。這兩個函式可接受的值範圍為十六進位 8000000000 或十進位 -549755813888 到十六進位 7FFFFFFFF 或十進位 549755813887。

如果您對這些函式傳遞單一數字或文字字串，則傳回值是單一結果。如果您傳遞單欄資料表，則傳回值會以單欄資料表顯示結果，引數資料表中的每筆記錄都有一個結果。如果您有多欄資料表，您可依照使用資料表所述，將該資料表改為單欄資料表。

如果輸入值超出範圍或包含無效的十六進位字元，則傳回 ErrorKind.Numeric 錯誤。如果輸入是單欄資料表，則錯誤將嵌入到輸出資料表中。

語法

Dec2Hex( Number [, Places] )

Number - 必要項目。要轉換為十六進位的數字。
地點 - 選擇性。如果數字為正數，則使用的字元數。如果省略 Places，則 Dec2Hex 將使用所需的最少字元數。如果提供了此參數，且結果不適合提供的空間，則會傳回 ErrorKind.Numeric 錯誤。如果要轉換的數字為負數，則會忽略 Places。

Hex2Dec( HexString )

HexString - 必要項目。要轉換為數字的十六進位數字字串。

範例

Hex2Dec 的基本用法

公式	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 ]`

Dec2Hex 的基本用法

公式	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" ]`

帶有 Places 參數的 Dec2Hex 的基本用法

公式	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)`

Dec2Hex 與單欄資料表和 Places 參數的基本用法

公式	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" ]`

共用方式為