int — это число из множества ℤ = {..., -2, -1, 0, 1, 2, ...}.
Целые числа (int) могут быть указаны в десятичной (основание 10), шестнадцатеричной (основание 16), восьмеричной (основание 8) или двоичной (основание 2) системе счисления. Для задания отрицательных целых (int) используют оператор отрицания
Для записи в восьмеричной системе счисления перед числом ставят 0
(ноль). Начиная с PHP 8.1.0 восьмеричной нотации также может предшествовать 0o
или 0O
. Для записи в шестнадцатеричной системе счисления необходимо поставить перед числом 0x
. Для записи в двоичной системе счисления необходимо поставить перед числом 0b
Начиная с PHP 7.4.0 целочисленные литералы могут содержать подчёркивания (_
) между цифрами для лучшей читаемости литералов. Эти подчёркивания удаляются сканером PHP.
Пример #1 Целые числа
<?php
$a = 1234; // десятичное число
$a = 0123; // восьмеричное число (эквивалентно 83 в десятичной системе)
$a = 0o123; // восьмеричное число (начиная с PHP 8.1.0)
$a = 0x1A; // шестнадцатеричное число (эквивалентно 26 в десятичной системе)
$a = 0b11111111; // двоичное число (эквивалентно 255 в десятичной системе)
$a = 1_234_567; // десятичное число (с PHP 7.4.0)
?>
Формально, структура целых чисел int принята в PHP 8.1.0 (ранее не допускались восьмеричные префиксы 0o
или 0O
, а до PHP 7.4.0 не допускалось подчёркивание):
десятичные : [1-9][0-9]*(_[0-9]+)* | 0 шестнадцатеричные : 0[xX][0-9a-fA-F]+(_[0-9a-fA-F]+)* восьмеричные : 0[oO]?[0-7]+(_[0-7]+)* двоичные : 0[bB][01]+(_[01]+)* целые : десятичные | шестнадцатеричные | восьмеричные | двоичные
Размер типа int зависит от платформы, хотя, как правило, максимальное значение примерно равно 2 миллиардам (это 32-битное знаковое). 64-битные платформы обычно имеют максимальное значение около 9E18. PHP не поддерживает беззнаковые целые числа (int). Размер int может быть определён с помощью константы PHP_INT_SIZE
, максимальное значение — с помощью константы PHP_INT_MAX
, а с помощью константы PHP_INT_MIN
можно определить минимальное значение.
Если PHP обнаружил, что число превышает размер типа int, он будет интерпретировать его в качестве float. Аналогично, если результат операции лежит за границами типа int, он будет преобразован во float.
Пример #2 Переполнение целых на 32-битных системах
<?php
$large_number = 2147483647;
var_dump($large_number); // int(2147483647)
$large_number = 2147483648;
var_dump($large_number); // float(2147483648)
$million = 1000000;
$large_number = 50000 * $million;
var_dump($large_number); // float(50000000000)
?>
Пример #3 Переполнение целых на 64-битных системах
<?php
$large_number = 9223372036854775807;
var_dump($large_number); // int(9223372036854775807)
$large_number = 9223372036854775808;
var_dump($large_number); // float(9.2233720368548E+18)
$million = 1000000;
$large_number = 50000000000000 * $million;
var_dump($large_number); // float(5.0E+19)
?>
В PHP нет оператора целочисленного (int) деления, для этого существует функция intdiv(). Результатом 1/2
будет float0.5
. Если привести значение к int, оно будет округлено вниз, то есть будет отброшена дробная часть числа. Для большего контроля над округлением используют функцию round().
<?php
var_dump(25/7); // float(3.5714285714286)
var_dump((int) (25/7)); // int(3)
var_dump(round(25/7)); // float(4)
?>
Для явного преобразования в тип int используют приведение (int)
или (integer)
. Однако в большинстве случаев в приведении типа нет необходимости, так как значение будет автоматически преобразовано, если оператор, функция или управляющая структура требует аргумент типа int. Значение также может быть преобразовано в тип int функцией intval().
Если значением с типом resource преобразовывается в значением с типом int, то результатом будет уникальный номер ресурса, привязанный к resource во время исполнения PHP программы.
Смотрите также: Манипуляции с типами.
Логическое значение false
преобразовывается в 0
(ноль), а true
— в 1
(единицу).
При преобразовании из float в int число будет округлено вниз. Начиная с PHP 8.1.0 при неявном преобразовании неинтегрального числа с плавающей точкой (float) в целое число (int), которое теряет точность, выдаётся уведомление об устаревании.
<?php
function foo($value): int {
return $value;
}
var_dump(foo(8.1)); // "Deprecated: Implicit conversion from float 8.1 to int loses precision" начиная с PHP 8.1.0
var_dump(foo(8.1)); // 8 до PHP 8.1.0
var_dump(foo(8.0)); // 8 в обоих случаях
var_dump((int)8.1); // 8 в обоих случаях
var_dump(intval(8.1)); // 8 в обоих случаях
?>
Если число с плавающей точкой превышает размеры int (обычно ± 2.15e+9 = 2^31
на 32-битных системах и ± 9.22e+18 = 2^63
на 64-битных системах, результат будет неопределённым, так как float не имеет достаточной точности, чтобы вернуть верный результат в виде целого числа (int). В этом случае не будет выведено ни предупреждения, ни даже замечания!
Замечание:
Значения NaN и Infinity при приведении к int становятся равными нулю, вместо неопределённого значения в зависимости от платформы.
Нельзя приводить неизвестную дробь к типу int, так как это иногда может дать неожиданные результаты.
<?php
echo (int) ( (0.1+0.7) * 10 ); // выводит 7!
?>
Подробнее об этом рассказано в предупреждении о точности чисел с плавающей точкой.
Если строка содержит число или ведущую числовую последовательность, тогда она будет преобразована в соответствующее целое число, в противном случае она преобразуется в ноль (0
).
Для других типов поведение преобразования в int не определено. Не нужно полагаться на наблюдаемое ранее поведение, так как оно может измениться без предупреждения.