整数

integer は、Z = {..., -2, -1, 0, 1, 2, ...}という集合 です。

任意精度整数 / GMP および float 任意精度整数 / BCMath も参照ください。

構文

整数 (integer) は、10 進数(基数 10)、16 進数 (基数 16)、8 進数 (基数 8) 表記で指定可能です。オプションで、符号(-または+)を前に付けることが可能です。

8 進数表記を使用する場合、数の前に 0 (ゼロ) を付ける必要があります。また、16 進数表記を使用するには、数の前に 0x を付ける必要があります。

例 11-1. 整数リテラル

<?php
$a
= 1234 ; // 10進整数
$a = - 123 ; // 負の数
$a = 0123 ; // 8進数 (10進数の83と等価)
$a = 0x1A ; // 16進数 (10進数の26と等価)
?>
使用可能な整数リテラルの形式は以下のように定義されています。

decimal     : [1-9][0-9]*             | 0  hexadecimal : 0[xX][0-9a-fA-F]+  octal       : 0[0-7]+  integer     : [+-]?decimal             | [+-]?hexadecimal             | [+-]?octal

整数のサイズはプラットフォームに依存しますが、 約 20 億 (32 ビット符号付) が一般的な値です。 PHP は符号無し整数をサポートしていません。

警告

8 進数の整数値として不正な数字(例: 8 または 9)が渡された場合、 数値の残りの部分は無視されます。

例 11-2. おかしな 8 進数

<?php
var_dump
( 01090 ); // 010(8 進数)= 8(10 進数)
?>

整数のオーバーフロー

integer 型の範囲外の数を指定した場合、かわりに float として解釈されます。また、結果が integer 型の範囲外の数となるような計算を行うと float が代わりに返されます。

<?php
$large_number
=   2147483647 ;
var_dump ( $large_number );
// 出力: int(2147483647)

$large_number =   2147483648 ;
var_dump ( $large_number );
// 出力: float(2147483648)

// 2^31 から 2^32-1 までの値については、指定した 16 進表現整数を出力できる
var_dump ( 0xffffffff );
// output: float(4294967295)

// 2^32-1 を超える値については、指定した 16 進表現整数を出力できない
var_dump ( 0x100000000 );
// 出力: int(2147483647)

$million = 1000000 ;
$large_number =   50000 * $million ;
var_dump ( $large_number );
// 出力: float(50000000000)
?>

警告

不幸にして、過去のスクリプトエンジンにはバグがあり、 負の数が含まれている場合に、常に正しく動作するわけではありませんでした。例えば、 -50000 * $million を実行した場合、結果は、 -429496728 となりました。 しかし、オペランドが共に正の場合は問題ありませんでした。

この問題は PHP 4.1.0 で解決されました。

PHP には整数の割り算はありません。 1/2 は float 型の 0.5 になります。 下方向の整数値に値を丸めるためにキャストを使用することができ、 また、 round() 関数を使用することもできます。

<?php
var_dump
( 25 / 7 );          // float(3.5714285714286)
var_dump ((int) ( 25 / 7 )); // int(3)
var_dump ( round ( 25 / 7 ));   // float(4)
?>

整数への変換

integer に値を明示的に変換するには、キャスト (int) または (integer) のどちらかを使用してください。しかし、多くの場合、演算子、関数、制御構造が integer 引数を必要とする場合、値は自動的に変換されるため、 キャストを使用する必要はありません。 関数 intval() を用いて値を整数に変換することも可能です。

型の相互変換 を参照ください。

booleans から

FALSE は、 0 (ゼロ) となり、 TRUE は、 1 となります。

浮動小数点数 から

float から整数に変換する場合、その数はゼロの方に丸められます。

float が整数の範囲 (通常は +/- 2.15e+9 = 2^31 ) を越える場合、結果は undefined となります。これは、 その float が正しい整数の結果を得るために十分な精度を得られなかったからです。 この場合、警告も通知も発生しません!

警告

未知の端数を integer にキャストしないでください。 この場合、予期しない結果となることがあります。

<?php
echo (int) ( ( 0.1 + 0.7 ) * 10 ); // 7が出力されます!
?>

より詳細な情報については、 float の精度に関する注意 を参照ください。

文字列から

文字列変換 を参照ください。

他の型から

注意

整数への変換の動作は、他の型については定義されません。 現在の動作は、その値がまず 論理値に変換された 場合と同じです。しかし、この動作は予告なく変更されることがありえるので、 これを前提にしていはいけません。