hex2num

IEEE の 16 進数形式の倍精度数への変換

構文

X = hex2num(hexStr)

説明

X = hex2num(hexStr) は、hexStr をそれが表す倍精度浮動小数点数に変換します。入力引数 hexStr は 16 進数を使用した IEEE^® 形式の数値を最大 16 文字で表します。hexStr が 16 桁未満の場合、hex2num は hexStr を右端までゼロで埋めます。

関数 hex2dec とは異なり、hex2num は小数部をもつ浮動小数点値を表す入力を変換できます。また、hex2num は、NaN 値、Inf 値および非正規数も正しく処理します。

hexStr が複数の数値を表す場合、hex2dec は倍精度数の列ベクトルとして数値を返します。

例

16 進数形式から小数部をもつ数値への変換

16 進数を使用して、IEEE® の形式で倍精度数を表す文字ベクトルを作成します。

hexStr = '400921fb54442d18';

それにより表される数値に変換するには、関数 hex2num を使用します。hexStr が小数部をもつ数値を表す場合、hex2num は正しく変換します。

X = hex2num(hexStr)

X = 3.1416

関数 num2hex を使用して、X を 16 進数表現に戻すことができます。

num2hex(X)

ans = 
'400921fb54442d18'

負の数値、NaN および Inf の 16 進数表現の変換

負の数値を表す文字ベクトルを作成します。次にそれを変換します。

hexStr = 'BFF';
X = hex2num(hexStr)

X = -1

NaN の表現を変換します。

hex2num('FFF8')

ans = NaN

Inf の表現を変換します。

hex2num('7FF')

ans = Inf

倍精度配列の戻り値

16 進数を使用して、複数の数値を IEEE® の形式で表す string 配列を作成します。

hexStr = ["4005bf0b0d7a3c06" "3fc189374bc6a7f0" "402c"]

hexStr = 1x3 string
    "4005bf0b0d7a3c06"    "3fc189374bc6a7f0"    "402c"

hexStr を変換し、倍精度数の配列として返します。

X = hex2num(hexStr)

X = 1×3

    2.7183    0.1370   14.0000

入力引数

hexStr — 16 進数を表すテキスト

文字配列 | 文字ベクトルの cell 配列 | string 配列

16 進数を表すテキスト。文字ベクトル、文字ベクトルの cell 配列、または string 配列として指定します。

• hexStr が文字ベクトルの cell 配列または string 配列の場合、hex2num は各要素を数値に変換。

• hexStr が文字配列の場合、hex2num は各行を数値に変換。

拡張機能

C/C++ コード生成

MATLAB® Coder™ を使用して C および C++ コードを生成します。

使用上の注意事項および制限事項:

• hex2num の出力が空の場合、生成コードは 0 行 0 列の配列ではなく、0 行 1 列の配列を返します。

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

この関数はスレッドベースの環境を完全にサポートしています。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

バージョン履歴

R2006a より前に導入

参考

num2hex | hex2dec | sprintf | format

トピック

• 16 進数値と 2 進数値

外部の Web サイト

• IEEE 754