gmp_setbit

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

gmp_setbit — Modifica un bit

Descripción

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

Modifica el bit index en num.

Parámetros

num: Un objeto GMP
index: El índice del byte a definir. El índice 0 representa el byte menos significativo.
value: true para definir el byte (definido a 1/on); false para reinicializarlo (definido a 0/off).

Valores devueltos

No se retorna ningún valor.

Ejemplos

Ejemplo #1 Ejemplo con gmp_setbit() - índice 0

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

El ejemplo anterior mostrará:

2 -> 0b10
3 -> 0b11

Ejemplo #2 Ejemplo con gmp_setbit() - índice 1

<?php
$a = gmp_init("0xfd");
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
gmp_setbit($a, 1); // el índice comienza en 0
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
?>

El ejemplo anterior mostrará:

253 -> 0b11111101
255 -> 0b11111111

Ejemplo #3 Ejemplo con gmp_setbit() - borra un byte

<?php
$a = gmp_init("0xff");
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
gmp_setbit($a, 0, false); // limpia el bit en el índice 0
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
?>

El ejemplo anterior mostrará:

255 -> 0b11111111
254 -> 0b11111110

Notas

Nota:
A diferencia de la mayoría de las otras funciones GMP, gmp_setbit() debe ser llamada con un objeto GMP ya existente (utilizando gmp_init() por ejemplo). No será creada automáticamente.

Véase también

gmp_clrbit() - Anula un byte
gmp_testbit() - Prueba si un bit está definido

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

+add a note

User Contributed Notes 1 note

down

bluej100@gmail ¶

19 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
?>

+add a note