(PHP 4 >= 4.0.4, PHP 5)
gmp_setbit — Establece el bit
&$a
, int $index
[, bool $bit_on = true
] )
Establece el index del bit en a.
aEl valor a modificar.
Puede ser tanto un número de resource GMP, o una cadena numérica dada que pueda ser convertida al final en un número.
indexEl índice del bit a establecer. El índice 0 representa el bit menos significativo.
bit_onVerdadero para establecer el bit (establecer a 1/on); falso para limpiar el bit (establecer a 0/off).
Un número de recurso GMP.
Ejemplo #1 Ejemplo de 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 resultado del ejemplo sería:
2 -> 0b10 3 -> 0b11
Ejemplo #2 Ejemplo de 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 empieza en 0
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
?>
El resultado del ejemplo sería:
253 -> 0b11111101 255 -> 0b11111111
Ejemplo #3 Ejemplo de gmp_setbit() - limpiar un bit
<?php
$a = gmp_init("0xff");
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
gmp_setbit($a, 0, false); // limpiar el bit en el índice 0
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
?>
El resultado del ejemplo sería:
255 -> 0b11111111 254 -> 0b11111110
Nota:
A diferencia de otras funciones GMP, gmp_setbit() debe ser llamado con un recurso GMP que ya exista (usando gmp_init() por ejemplo). No puede ser automáticamente creado.