PHP 8.3.4 Released!

gmp_setbit

(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)

gmp_setbitビットを設定する

説明

gmp_setbit(GMP $num, int $index, bool $value = true): void

num のビット index を設定します。

パラメータ

num

GMP オブジェクト

GMP オブジェクト、整数、あるいは数値に変換可能な数値形式の文字列。

index

設定するビットのインデックス。0 は最下位ビットを表します。

value

true にするとそのビットを設定し (値を 1/on にし)、 false にするとそのビットをクリアします (値を 0/off にします)。

戻り値

GMP オブジェクトを返します。

例1 gmp_setbit() の例 - インデックス 0

<?php
$a
= gmp_init("2"); //
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
gmp_setbit($a, 0); // 0b10 が 0b11 になります
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
?>

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

2 -> 0b10
3 -> 0b11

例2 gmp_setbit() の例 - インデックス 1

<?php
$a
= gmp_init("0xfd");
echo
gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
gmp_setbit($a, 1); // インデックスは 0 から始まります
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
?>

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

253 -> 0b11111101
255 -> 0b11111111

例3 gmp_setbit() の例 - ビットのクリア

<?php
$a
= gmp_init("0xff");
echo
gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
gmp_setbit($a, 0, false); // インデックス 0 のビットをクリアします
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
?>

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

255 -> 0b11111111
254 -> 0b11111110

注意

注意:

他の大半の GMP 関数とは異なり、gmp_setbit() は必ず既存の GMP オブジェクト (例えば gmp_init() を使用して取得したもの) を使用してコールしなければなりません。 リソースは自動的には作成されません。

参考

add a note

User Contributed Notes 1 note

up
0
bluej100@gmail
16 years ago
The third parameter is somewhat confusingly named; it would probably be better described as "$set_state". If true, it sets the bit to 1. If false, it sets the bit to 0. Default is true.

<?php
$num
= gmp_init(1);
gmp_setbit($num, 1);
echo
'gmp_setbit(1, 1): '.gmp_strval($num, 2)."\n"; // 11

$num = gmp_init(1);
gmp_setbit($num, 1, true);
echo
'gmp_setbit(1, 1, true): '.gmp_strval($num, 2)."\n"; // 11

$num = gmp_init(1);
gmp_setbit($num, 0, false);
echo
'gmp_setbit(1, 0, false): '.gmp_strval($num, 2)."\n"; // 0
?>
To Top