gmp_export

(PHP 5 >= 5.6.1, PHP 7, PHP 8)

gmp_export — バイナリ文字列にエクスポートする

function gmp_export(GMP|int|string $num, int $word_size = 1, int $flags = GMP_MSW_FIRST | GMP_NATIVE_ENDIAN): string

GMP数をバイナリ文字列にエクスポートします。この関数では、PHP ネイティブの整数型の範囲を超える任意の大きさの数を扱え、ワードごとのバイト数とバイトオーダーも指定できます。考え方は pack() と似ています。

数値の符号は無視されます。負の数をエクスポートすると、その絶対値をエクスポートした場合と同じ結果になります。

num: エクスポートするGMP数
word_size: 出力する各ワードのバイト数を指定します。返される文字列全体の長さは、この値の倍数になります。デフォルト値は 1 です。
flags: ワードの順序とバイトオーダーを制御するビットマスク。ワードの順序は、GMP_MSW_FIRST (最上位ワードが先頭。デフォルト) または GMP_LSW_FIRST (最下位ワードが先頭) で指定します。各ワード内のバイトオーダーは、 GMP_NATIVE_ENDIAN (デフォルト)、 GMP_BIG_ENDIAN、 GMP_LITTLE_ENDIAN のいずれかで指定します。デフォルト値は GMP_MSW_FIRST | GMP_NATIVE_ENDIAN です。

GMP 数のバイナリ表現を含む文字列を返します。数値がゼロの場合は、空文字列を返します。

バージョン	説明
8.0.0	この関数は、失敗時に `false` を返さなくなりました。

例1 gmp_export() の例

<?php
$number = gmp_init(16705);
echo gmp_export($number) . "\n";
?>

上の例の出力は以下となります。

AA

There are no user contributed notes for this page.