PHP Conference Nagoya 2025

gmp_setbit

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

gmp_setbitEstablece el bit

Descripción

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

Establece el index del bit en num.

Parámetros

num

El valor a modificar.

resource de número de GMP en PHP 5.5 y anterior, o un objeto de GMP en PHP 5.6 y posterior, o un string numérico siempre que sea posible convertirlo a un número.

index

El índice del bit a establecer. El índice 0 representa el bit menos significativo.

value

Verdadero para establecer el bit (establecer a 1/on); falso para limpiar el bit (establecer a 0/off).

Valores devueltos

resource de número de GMP en PHP 5.5 y anterior, o un objeto GMP en PHP 5.6 y posterior.

Ejemplos

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

Notas

Nota:

A diferencia de otras funciones GMP, gmp_setbit() debe ser llamado con un Objeto GMP que ya exista (usando gmp_init() por ejemplo). No puede ser automáticamente creado.

Ver también

add a note

User Contributed Notes 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