gmp_export

(PHP 5 >= 5.6.1, PHP 7, PHP 8)

gmp_export — Exportation vers une chaîne binaire

Description

function gmp_export(GMP|int|string $num, int $word_size = 1, int $flags = GMP_MSW_FIRST | GMP_NATIVE_ENDIAN): string

Exporte un nombre GMP vers une chaîne binaire. Cette fonction peut traiter des nombres arbitrairement grands, au-delà de l'intervalle du type entier natif de PHP, avec une taille de mot et un ordre des octets configurables, dans le même esprit que pack().

Le signe du nombre est ignoré ; exporter un nombre négatif produit le même résultat que d'exporter sa valeur absolue.

Liste de paramètres

num

Le nombre GMP à exporter.

word_size

Le nombre d'octets par mot dans les données de sortie. La longueur totale de la chaîne retournée sera un multiple de cette valeur. Valeur par défaut : 1.

flags

Un masque de bits contrôlant l'ordre des mots et l'ordre des octets. Ordre des mots : GMP_MSW_FIRST (mot le plus significatif en premier, par défaut) ou GMP_LSW_FIRST (mot le moins significatif en premier). Ordre des octets au sein de chaque mot : GMP_NATIVE_ENDIAN (par défaut), GMP_BIG_ENDIAN ou GMP_LITTLE_ENDIAN. Valeur par défaut : GMP_MSW_FIRST | GMP_NATIVE_ENDIAN.

Valeurs de retour

Retourne une chaîne de caractères contenant la représentation binaire du nombre GMP. La chaîne est vide si le nombre vaut zéro.

Historique

Version Description
8.0.0 Cette fonction ne retourne plus false en cas d'échec.

Exemples

Exemple #1 Exemple avec gmp_export()

<?php
$number = gmp_init(16705);
echo gmp_export($number) . "\n";
?>

L'exemple ci-dessus va afficher :

AA

Voir aussi

Found A Problem?

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

User Contributed Notes

There are no user contributed notes for this page.