gmp_strval
(PHP 4 >= 4.0.4, PHP 5, PHP 7)
gmp_strval — Преобразование GMP числа в строку
Описание
Преобразует GMP число в строку в системе счисления
base. По умолчанию числа преобразуются в
десятеричной системе счисления.
Список параметров
-
gmpnumber -
GMP число для конвертации.
Или ресурс resource GMP числа в PHP 5.5 и ранее, или объект класса GMP в PHP 5.6 и новее, или числовая строка, при условии, что ее можно преобразовать в число позже.
-
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));
?>
- PHP Руководство
- Функции по категориям
- Индекс функций
- Справочник функций
- Математические расширения
- GNU Вычисления с увеличенной точностью
- gmp_abs
- gmp_add
- gmp_and
- gmp_clrbit
- gmp_cmp
- gmp_com
- gmp_div_q
- gmp_div_qr
- gmp_div_r
- gmp_div
- gmp_divexact
- gmp_export
- gmp_fact
- gmp_gcd
- gmp_gcdext
- gmp_hamdist
- gmp_import
- gmp_init
- gmp_intval
- gmp_invert
- gmp_jacobi
- gmp_legendre
- gmp_mod
- gmp_mul
- gmp_neg
- gmp_nextprime
- gmp_or
- gmp_perfect_square
- gmp_popcount
- gmp_pow
- gmp_powm
- gmp_prob_prime
- gmp_random_bits
- gmp_random_range
- gmp_random_seed
- gmp_random
- gmp_root
- gmp_rootrem
- gmp_scan0
- gmp_scan1
- gmp_setbit
- gmp_sign
- gmp_sqrt
- gmp_sqrtrem
- gmp_strval
- gmp_sub
- gmp_testbit
- gmp_xor
Коментарии
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!).I think it's no longer necessary to worry about trailing nulls. This was fixed in Feb 2002 (see bug 10133)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.
It may be worth noting that using gmp_strval can slow your script down a lot with large numbers.
This script for example, produces factorials in succession:
<?php
$start = microtime(TRUE);
$fact = gmp_init(1, 10);
for($i=1;$i<100000;$i++) { // calculates 100,000 factorials
$fact = gmp_mul($fact, $i); // $fact is now the result of the $ith factorial
// gmp_strval($fact, 10); // see below...
if(microtime(TRUE)-$start>1) // stop calculating after 1 second
break;
}
// print whatever result that took 1 second to complete
printf("\$i = %d\n\$fact = %s\n", gmp_strval($fact, 10));
?>
My server calculates around about the 69,500th factorial on average every time. Uncommenting that gmp_strval line slows this process down dramatically, and only calculates about 5,000 factorials. This is about 14 times longer than before (this is consistent with allowing it to run for any number of seconds, not just 1).
Nitrogen.
casting to string seems to do the same (for base10) and it's much faster
(string) $num
instead of
gmp_strval($num)