gmp_setbit
(PHP 4 >= 4.0.4, PHP 5, PHP 7)
gmp_setbit — Установка бита
Описание
Устанавливает в 1 бит с индексом index в числе a.
Список параметров
-
a -
Изменяемое значение.
Или ресурс resource GMP числа в PHP 5.5 и ранее, или объект класса GMP в PHP 5.6 и новее, или числовая строка, при условии, что ее можно преобразовать в число позже.
-
index -
Индекс устанавливаемого бита. Индекс 0 указывает на младший бит.
-
bit_on -
True для установки бита (установки в 1/включен); false для его очистки (установки в 0/выключен).
Возвращаемые значения
Ресурс resource GMP числа в PHP 5.5 и ранее, или объект класса GMP в PHP 5.6 и новее.
Примеры
Пример #1 Пример использования gmp_setbit() - 0 индекс
<?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";
?>
Результат выполнения данного примера:
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); // index starts at 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); // clear bit at index 0
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
?>
Результат выполнения данного примера:
255 -> 0b11111111 254 -> 0b11111110
Примечания
Замечание:
В отличие от большинства GMP функций, gmp_setbit() должна вызываться для уже существующего GMP ресурса (например, созданного функцией gmp_init()). Число не будет создаваться автоматически.
- PHP Руководство
- Функции по категориям
- Индекс функций
- Справочник функций
- Математические расширения
- GNU Вычисления с увеличенной точностью
- gmp_abs
- gmp_add
- gmp_and
- gmp_clrbit
- gmp_cmp
- gmp_com
- gmp_div_q
- gmp_div_qr
- gmp_div_r
- gmp_div
- gmp_divexact
- gmp_export
- gmp_fact
- gmp_gcd
- gmp_gcdext
- gmp_hamdist
- gmp_import
- gmp_init
- gmp_intval
- gmp_invert
- gmp_jacobi
- gmp_legendre
- gmp_mod
- gmp_mul
- gmp_neg
- gmp_nextprime
- gmp_or
- gmp_perfect_square
- gmp_popcount
- gmp_pow
- gmp_powm
- gmp_prob_prime
- gmp_random_bits
- gmp_random_range
- gmp_random_seed
- gmp_random
- gmp_root
- gmp_rootrem
- gmp_scan0
- gmp_scan1
- gmp_setbit
- gmp_sign
- gmp_sqrt
- gmp_sqrtrem
- gmp_strval
- gmp_sub
- gmp_testbit
- gmp_xor
Коментарии
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
?>