Устанавливает бит

# gmp_setbit

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

gmp_setbit — Устанавливает бит

### Описание

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

Функция устанавливает в числе `num` бит, позицию которого указали в аргументе `index`.

### Список параметров

`num`

  Объект GMP.

`index`

  Индекс бита, который требуется установить. Индекс 0 представляет младший бит — бит с наименьшим значением.

`value`

  Значение `true` установит, или включит, бит путём установки значения 1; значение `false` сбросит, или выключит, бит путём установки значения 0.

### Возвращаемые значения

Функция не возвращает значения после выполнения.

### Примеры

Пример #1 Пример установки бита с индексом 0 функцией gmp_setbit()

    <?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 Пример установки бита с индексом 1 функцией gmp_setbit()

    <?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(). Функция не создаёт объект числа автоматически.

### Смотрите также

- gmp_clrbit() - Сбрасывает бит
- gmp_testbit() - Проверка, установлен ли бит в 1

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open