Целые числа

Тип 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.

Из NULL

Значение null преобразовывается в ноль — 0.

Из других типов

Предостережение

У поведения преобразования в тип int из других типов нет определения. Нельзя полагаться на наблюдаемое поведение, поскольку оно изменится в новых версиях языка без предупреждения.