gmp_setbit

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

gmp_setbit — Modifie un bit

Description

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

Modifie le bit index dans num.

Liste de paramètres

num: Un objet GMP
index: L'index de l'octet à définir. L'index 0 représente l'octet le moins significatif.
value: true pour définir l'octet (défini à 1/on) ; false pour le ré-initialiser (défini à 0/off).

Valeurs de retour

Un objet GMP.

Exemples

Exemple #1 Exemple avec gmp_setbit() - index 0

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

L'exemple ci-dessus va afficher :

2 -> 0b10
3 -> 0b11

Exemple #2 Exemple avec gmp_setbit() - index 1

<?php
$a = gmp_init("0xfd");
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
gmp_setbit($a, 1); // index commence à 0
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
?>

L'exemple ci-dessus va afficher :

253 -> 0b11111101
255 -> 0b11111111

Exemple #3 Exemple avec gmp_setbit() - annule un octet

<?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";
?>

L'exemple ci-dessus va afficher :

255 -> 0b11111111
254 -> 0b11111110

Notes

Note:
Contrairement à la plupart des autres fonctions GMP, gmp_setbit() doit être appelée avec un objet GMP existant déjà (en utilisant gmp_init() par exemple). Elle ne sera pas automatiquement créée.

Voir aussi

gmp_clrbit() - Annule un octet
gmp_testbit() - Teste si un octet est défini

Improve This Page

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

＋add a note

User Contributed Notes 1 note

down

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

＋add a note