PHP 8.4.2 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.

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

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

Добавить

Примечания пользователей 1 note

up
0
bluej100@gmail
17 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