次の方法で共有


Dec2Hex および Hex2Dec 関数

適用対象: キャンバス アプリ Dataverse ローコード プラグイン デスクトップ フロー モデル駆動型アプリ Power Pages Power Platform CLI

16 進数のテキスト文字列と数値を変換する。

Description

数値を 16 進数のテキスト文字列に変換するには、Dec2Hex 関数を使用します。 Dec2Hex は、 0 から 9 までの文字と A から Fまでの大文字を出力します。必要に応じて、 Lower 関数を使用して結果を小文字に変換します。 Dec2Hex は、 Trunc 関数が最初に適用されたかのように、入力数値を整数に切り捨てます。 正の数を先頭の 0 (ゼロ) で埋め、出力の長さを制限するには、Places を使用します: 入力が負の場合、Places は無視されます。

16 進数 (0 から 9A から F) を含むテキスト文字列を数値に変換するには、Hex2Dec 関数を使用します。 大文字、小文字は問いません。 Hex2Dec に渡せる 16 進数は 10 文字までです。

これらの関数はどちらも 40 ビット、2 補数、整数で動作します。 両方の関数で使用可能な値の範囲は、16 進数 8000000000 または 10 進数 -549755813888 から 16 進数 7FFFFFFFF または 10 進数 549755813887 です。

これらの関数に単一の数値またはテキスト文字列を渡すと、戻り値は単一の結果となります。 単一列の テーブル を渡した場合、戻り値はシングル・カラムの結果テーブルとなり、引数のテーブルの各レコードに対して 1 つの結果が返されます。 複数列テーブルがある場合は、テーブルの使用 に関するページの説明に従って、そのテーブルを単一列テーブルにすることができます。

入力値が範囲外であるか、無効な 16 進文字が含まれている場合は、ErrorKind.Numeric エラーが返されます。 入力が単一列のテーブルだった場合、エラーは出力テーブルに埋め込まれます。

構文

Dec2Hex( 数値 [, ] )

  • 番号 - 必須。 16 進数に変換する数値です。
  • 場所 - オプション。 数字が正の場合に使用する文字数です。 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" ]