Dec2Hex および Hex2Dec 関数
適用先 : 
キャンバス アプリ Dataverse ローコード プラグイン デスクトップ フロー モデル駆動型アプリ Power Platform CLI
16 進数のテキスト文字列と数値を変換する。
Description
数値を 16 進数のテキスト文字列に変換するには、Dec2Hex 関数を使用します。 Dec2Hex は、0 から 9 までの文字と、A から F までの大文字を出力します。必要に応じて、結果を小文字に変換するには Lower 関数を使用します。 Dec2Hex は、Trunc 関数が最初に適用されたかのように、入力数値を整数に切り捨てます。 正の数を先頭の 0 (ゼロ) で埋め、出力の長さを制限するには、Places を使用します: 入力が負の場合、Places は無視されます。
16 進数 (0 から 9 と A から F) を含むテキスト文字列を数値に変換するには、Hex2Dec 関数を使用します。 大文字、小文字は問いません。 Hex2Dec に渡せる 16 進数は 10 文字までです。
これらの関数はどちらも 40 ビット、2 補数、整数で動作します。 両方の関数で使用可能な値の範囲は、16 進数 8000000000 または 10 進数 -549755813888 から 16 進数 7FFFFFFFF または 10 進数 549755813887 です。
これらの関数に単一の数値またはテキスト文字列を渡すと、戻り値は単一の結果となります。 単一列の テーブル を渡した場合、戻り値はシングル・カラムの結果テーブルとなり、引数のテーブルの各レコードに対して 1 つの結果が返されます。 複数列テーブルがある場合は、テーブルの使用 に関するページの説明に従って、そのテーブルを単一列テーブルにすることができます。
入力値が範囲外であるか、無効な 16 進文字が含まれている場合は、ErrorKind.Numeric エラーが返されます。 入力が単一列のテーブルだった場合、エラーは出力テーブルに埋め込まれます。
構文
Dec2Hex( Number [, Places] )
- Number - 必須。 16 進数に変換する数値です。
- Places - 任意。 数字が正の場合に使用する文字数です。 Places が省略された場合、Dec2Hex は必要最小限の文字数を使用します。 このパラメータが提供され、結果が提供されたスペースに収まらない場合、ErrorKind.Numeric エラーが返されます。 Places は、変換する数値が負の場合は無視されます。
Hex2Dec( HexString )
- HexString - 必須。 数値に変換する 16 進数の文字列です。
使用例
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" ] |
Dec2Hex の基本的な使い方と Places 引数
| 式 | 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" ] |