GMP 関数

導入

以下の関数により、GNU MP ライブラリを使用して任意長の整数を使用することが可能になります。

これらの関数は、PHP 4.0.4 で追加されました。

注意: 多くの GMP 関数は、resource で定義された GMP 数を引数としてとります。しかし、これらの関数の多くは、数値と文字列の両方を引数として指定可能で、後者は数値に変換することが可能です。また、整数引数を使用して処理を行うより高速な関数がある場合には、指定された引数が整数である場合により低速となる関数の代わりに使用されます。これは透過的に行われるため、結果的に、GMP 数値を引数とする全ての関数について整数を使用することが可能です。関数 gmp_init() も参照ください。

警告

より大きな整数を明示的に指定するには、文字列として指定してください。そうしない場合、PHP は値ををまず整数リテラルとして解釈し、 GMP にわたるまでに精度の劣化を生じる可能性があります。

注意: PHP 5.1.0 以降、この拡張モジュールは Windows でも使用可能です。

要件

» https://www.swox.com/gmp/ から GMP ライブラリをダウンロード可能です。このサイトでは、GMP のマニュアルも入手可能です。

これらの関数を使用するには、GMP バージョン 2 以降が必要です。中には、より新しいバージョンの GMP ライブラリを必要とする関数もあります。

インストール手順

これらの関数を利用可能とするには、オプション --with-gmp を使用することにより GMP サポートを有効にして PHP をコンパイルする必要があります。

実行時設定

設定ディレクティブは定義されていません。

リソース型

ほとんどの GPM 関数は、GMP 数のリソースを使用するか、それを返します。

定義済み定数

以下の定数が定義されています。この関数の拡張モジュールが PHP 組み込みでコンパイルされているか、実行時に動的にロードされている場合のみ使用可能です。

GMP_ROUND_ZERO (integer)
GMP_ROUND_PLUSINF (integer)
GMP_ROUND_MINUSINF (integer)
GMP_VERSION (string): GMP ライブラリのバージョン。

例

Example#1 GMP を使用した階乗関数


<?php
function fact($x) 
{
    $return = 1;
    for ($i=2; $i < $x; $i++) {
        $return = gmp_mul($return, $i);
    }
    return $return;
}

echo gmp_strval(fact(1000)) . "\n";
?>