PHPのgmp_testbit()関数の使い方をわかりやすく解説

gmp_testbit() 関数は、GMP 数値（多倍長整数）の指定した位置のビットがセット（1）されているかどうかを判定する関数です。ビット単位の操作を行いたい場合に便利です。

構文

gmp_testbit(val, index)

パラメータ

• val: チェック対象となる GMP 数値。
• index: チェックするビットのインデックス（位置）。インデックスは 0 から始まる点に注意してください。

戻り値

指定したインデックスのビットがセットされている場合は true を返し、セットされていない場合は false を返します。なお、インデックスに負の値を指定すると警告（E_WARNING）が発生します。

使用例

以下は、gmp_testbit() 関数を使ってビットの状態を確認する例です。

<?php
   $val = "9";
   $index = 3;
   var_dump(gmp_testbit($val, $index));
?>

この例では、数値「9」は2進数で「1001」と表されます。右側から数えて 4 ビット目（インデックス 3）が「1」になっているため、true が返されます。

出力結果

上記のコードを実行すると、次のような出力が得られます。

bool(true)

セットされていないビットをチェックした場合

比較として、セットされていないビットを指定した例も見てみましょう。

<?php
   $val = "9";
   $index = 1;
   var_dump(gmp_testbit($val, $index));
?>

数値「9」（2進数で「1001」）のインデックス 1 のビットは「0」であるため、結果は false になります。

bool(false)

まとめ

gmp_testbit() 関数を使うことで、大きな整数を扱える GMP 数値に対して、特定のビットが立っているかどうかを簡単に調べることができます。フラグ管理やビット演算による状態判定などに活用するとよいでしょう。