Целые числа

Тип 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(), которая точнее контролирует округление.

Пример #3 Деление

<?php

var_dump(25 / 7);         // float(3.5714285714286)
var_dump((int) (25 / 7)); // int(3)
var_dump(round(25 / 7));  // float(4)

?>

Преобразование в целое

Для явного преобразования значение в целое число (int), используйте приведение типов (int). Однако в большей части случаев приведение типа не требуется, поскольку PHP автоматически преобразует значение, если оператору, функции или управляющей структуре требуется аргумент с типом int. Преобразовывать значение в тип int также умеет функция intval().

Преобразование значения с типом resource в тип int вернёт уникальный номер ресурса, который PHP присвоил значению с типом resource во время выполнения.

Смотрите также раздел «Жонглирование типами».

Из логического типа

Логическое значение false преобразовывается в ноль — 0, а true в единицу — 1.

Из чисел с плавающей точкой

При преобразовании из типа float в тип int PHP округлит число в меньшую сторону. Начиная с PHP 8.1.0 при неявном преобразовании неинтегрального числа с плавающей точкой (float) в целое число (int), которое теряет точность, PHP выдаёт уведомление об устаревании.

Пример #4 Приведение из числа с плавающей точкой

<?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!

?>

Подробнее об этом рассказывает параграф с предупреждением о точности чисел с плавающей точкой.

Из строк

Числовые строки или строки, которые начинаются с числовых символов, разрешаются в целочисленные значения, остальные строки преобразовываются в значение 0.

Из NULL

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

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

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

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