downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

gmp_sub> <gmp_sqrtrem
[edit] Last updated: Fri, 10 Feb 2012

view this page in

gmp_strval

(PHP 4 >= 4.0.4, PHP 5)

gmp_strvalConvertit un nombre GMP en chaîne

Description

string gmp_strval ( resource $gmpnumber [, int $base = 10 ] )

Convertit un nombre GMP en chaîne de caractères, dans la base base. La base par défaut est 10.

Liste de paramètres

gmpnumber

Le nombre GMP qui doit être converti.

Il peut être soit une ressource GMP, soit une chaîne numérique qu'il est possible de convertir plus tard en un nombre.

base

La base du nombre retourné. Par défaut, vaut 10. Les valeurs possibles vont de 2 à 62 et de -2 à -36.

Valeurs de retour

Le nombre, sous la forme d'une chaîne de caractères.

Historique

Version Description
5.3.2 Le paramètre base a été étendu de "2 à 36", à "2 à 62" et "-2 à -36".

Notes

Note:

Pour utiliser la base étendue introduite en PHP 5.3.2, vous devez compiler PHP avec GMP 4.2.0 ou supérieur.

Exemples

Exemple #1 Convertir un nombre GMP en chaîne de caractères

<?php
$a 
gmp_init("0x41682179fbf5");
printf("Décimal : %s, 36-based : %s"gmp_strval($a), gmp_strval($a,36));
?>



gmp_sub> <gmp_sqrtrem
[edit] Last updated: Fri, 10 Feb 2012
 
add a note add a note User Contributed Notes gmp_strval
russell dot s dot harper at gmail dot com 26-May-2010 10:22
A gotcha when using the value from gmp_strval as a key in an associative array. Some numbers are 2^31 are converted to signed integer format, this is usually incorrect.

<?php

$a
= gmp_init('2147483649'); // = 2^31 + 1
$b = gmp_init('3173604585'); // = 2^31 < $b < 2^32

$c = gmp_strval($a);
$d = gmp_strval($b);

$e = array($c => 'c', $d => 'd');

print
'*** Expect '."\n";
print
'Array '."\n".'('."\n".'    ['.$c.'] => c'."\n".'    ['.$d.'] => d'."\n".')'."\n\n";
print
'*** Actual '."\n";
print_r($e);

?>

Output:

*** Expect
Array
(
    [2147483649] => c
    [3173604585] => d
)

*** Actual
Array
(
    [-2147483647] => c
    [3173604585] => d
)

A workaround is to format as base 16 and append '0x' before using as a key.
php at richardneill dot org 19-Sep-2006 04:47
I think it's no longer necessary to worry about trailing nulls. This was fixed in Feb 2002 (see bug 10133)
caldwell at utm dot NoSpamPlease dot edu 22-Jul-2001 08:17
Warning: gmp_strval may return a null terminated string (e.g., gmp_strval(gmp_init(8)) has two characters. This is because gmp is built for speed, so uses estimates based on things it can get quickly, like the number of bits in N. So since 8 is a 4 bit number, it will be allocated ceil(log10(2^4))=ceil(4*0.30103....) = 2 characters. The gmp folks feel it is the caller's responsibility (in this case the PHP interface) to check whether or not all the characters were required.  PHP might have done this for us (and may in the future), but for now, you need to check (if it matters to you--it sure did in my program!).

 
show source | credits | stats | sitemap | contact | advertising | mirror sites