PHP-Handbuch: Set bit

Beschreibung

void gmp_setbit ( GMP &$a , int $index [, bool $bit_on = true ] )

Sets bit index in a.

Parameter-Liste

a

The value to modify.

Dies kann entweder eine resource für einen GMP-Wert in PHP 5.5 oder voher sein, ein GMP-Objekt in PHP 5.6 und später oder ein numerischer String, wenn es möglich ist, diesen in einen GMP-Wert umzuwandeln.

index

The index of the bit to set. Index 0 represents the least significant bit.

bit_on

True to set the bit (set it to 1/on); false to clear the bit (set it to 0/off).

Rückgabewerte

Eine resource für einen GMP-Wert in PHP 5.5 oder vorher, oder ein GMP-Objekt in PHP 5.6 und später.

Beispiele

Beispiel #1 gmp_setbit example - 0 index


<?php
$a = gmp_init("2"); //
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
gmp_setbit($a, 0); // 0b10 now becomes 0b11
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

2 -> 0b10
3 -> 0b11

Beispiel #2 gmp_setbit example - 1 index


<?php
$a = gmp_init("0xfd");
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
gmp_setbit($a, 1); // index starts at 0
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

253 -> 0b11111101
255 -> 0b11111111

Beispiel #3 gmp_setbit example - clearing a bit


<?php
$a = gmp_init("0xff");
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
gmp_setbit($a, 0, false); // clear bit at index 0
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

255 -> 0b11111111
254 -> 0b11111110

Anmerkungen

Hinweis:
Unlike most of the other GMP functions, gmp_setbit must be called with a GMP resource that already exists (using gmp_init for example). One will not be automatically created.

Siehe auch

gmp_clrbit
gmp_testbit