Тип 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, PHP преобразует результат во float.
Пример #2 Пример переполнения целых чисел
<?php
$large_number = 50000000000000000000;
var_dump($large_number); // float(5.0E+19)
var_dump(PHP_INT_MAX + 1); // В 32-разрядной системе system: float(2147483648)
// В 64-разрядной системе: float(9.2233720368548E+18)
?>
В PHP нет оператора целочисленного (int) деления,
для этого пользуются функцией intdiv().
Результат вычисления выражения 1/2
выдаёт число с плавающей точкой (float) 0.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)
. Однако
в большей части случаев приведение типа не требуется, поскольку PHP автоматически
преобразует значение, если оператору, функции или управляющей структуре
требуется аргумент с типом int. Преобразовывать значение
в тип int также умеет функция intval().
Преобразование значения с типом resource в тип int вернёт уникальный номер ресурса, который PHP присвоил значению с типом resource во время выполнения.
Смотрите также раздел «Жонглирование типами».
Логическое значение false
преобразовывается в ноль — 0
,
а true
в единицу — 1
.
При преобразовании из типа float в тип int PHP округлит число в меньшую сторону. Начиная с PHP 8.1.0 при неявном преобразовании неинтегрального числа с плавающей точкой (float) в целое число (int), которое теряет точность, PHP выдаёт уведомление об устаревании.
<?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).
PHP для таких случаев не выведет ни предупреждения, ни даже замечания!
Замечание:
Значения
NaN
,Inf
и-Inf
при приведении к типу int становятся равными нулю.
Нельзя приводить неизвестную дробь к типу int, поскольку это иногда даёт неожиданные результаты.
<?php
echo (int) ((0.1 + 0.7) * 10); // выводит 7!
?>
Подробнее об этом рассказывает параграф с предупреждением о точности чисел с плавающей точкой.
PHP преобразует числовую строку или строку с начальной числовой последовательностью
в число с плавающей точкой, если строка —
числовая строка
или в начале строки идёт числовая последовательность,
иначе строка преобразовывается в ноль — 0
.
У поведения преобразования в тип int из других типов нет определения. Нельзя полагаться на наблюдаемое поведение, поскольку оно изменится в новых версиях языка без предупреждения.