SunshinePHP Developer Conference 2015

gmp_strval

(PHP 4 >= 4.0.4, PHP 5)

gmp_strvalGMP 数を文字列に変換する

説明

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

GMP 数を base を基数とする文字列表現に変換します。 デフォルトの基数は 10 です。

パラメータ

gmpnumber

文字列の変換したい GMP 数。

PHP 5.5 以前での GMP 数リソース、PHP 5.6 以降での GMP オブジェクト、あるいは数値に変換可能な数値形式の文字列。

base

返り値の基数。デフォルトは 10 です。 基数として使用可能な値は 2 から 62 までおよび -2 から -36 までです。

返り値

数を文字列で表したものを返します。

変更履歴

バージョン 説明
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("10 進数: %s, 36 進数: %s"gmp_strval($a), gmp_strval($a,36));
?>

add a note add a note

User Contributed Notes 3 notes

up
0
russell dot s dot harper at gmail dot com
4 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
8 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
13 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!).
To Top