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

search for in the

gmp_sub> <gmp_sqrtrem
[edit] Last updated: Fri, 24 May 2013

view this page in

gmp_strval

(PHP 4 >= 4.0.4, PHP 5)

gmp_strvalПреобразование GMP числа в строку

Описание

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

Преобразует GMP число в строку в системе счисления base. По умолчанию числа преобразуются в десятеричной системе счисления.

Список параметров

gmpnumber

GMP число для конвертации.

Может быть как числом GMP, так и строкой, при условии, что ее значение можно конвертировать в число.

base

Система счисления возвращаемого числа. По умолчанию - 10. Возможные значения: от 2 до 62 и от -2 до -36.

Возвращаемые значения

Число в виде строки типа string.

Список изменений

Версия Описание
5.3.2 Диапазон возможных систем счисления base расширен со значений 2 - 36, до 2 - 62 и -2 - -36.

Примечания

Замечание:

Для использования расширенного диапазона систем счисления введенного в PHP 5.3.2, PHP должен быть скомпилирован с библиотекой GMP версии 4.2.0 или выше.

Примеры

Пример #1 Преобразование GMP числа в строку

<?php
$a 
gmp_init("0x41682179fbf5");
printf("Десятичное: %s, 36-ричное: %s"gmp_strval($a), gmp_strval($a,36));
?>



gmp_sub> <gmp_sqrtrem
[edit] Last updated: Fri, 24 May 2013
 
add a note add a note User Contributed Notes gmp_strval - [3 notes]
up
0
russell dot s dot harper at gmail dot com
2 years ago
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.
up
0
php at richardneill dot org
6 years ago
I think it's no longer necessary to worry about trailing nulls. This was fixed in Feb 2002 (see bug 10133)
up
0
caldwell at utm dot NoSpamPlease dot edu
11 years ago
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