gmp_scan1
gmp_sign
GMP Funktionen
PHP Manual

# gmp_setbit

(PHP 4 >= 4.0.4, PHP 5)

gmp_setbit — Set bit

### Beschreibung

void gmp_setbit ( resource `&$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 sein 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.

### 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() - Clear bit
- gmp_testbit() - Tests if a bit is set

gmp_scan1
gmp_sign
GMP Funktionen
PHP Manual