array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'language.types.integer.php', 1 => 'Целые числа', ), 'up' => array ( 0 => 'language.types.php', 1 => 'Типы', ), 'prev' => array ( 0 => 'language.types.boolean.php', 1 => 'Логические значения', ), 'next' => array ( 0 => 'language.types.float.php', 1 => 'Числа с плавающей точкой', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'language/types/integer.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
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
будет 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)
. Однако
в большинстве случаев в приведении типа нет необходимости, так как значение
будет автоматически преобразовано, если оператор, функция или управляющая структура
требует аргумент типа 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 не определено. Не нужно полагаться на наблюдаемое ранее поведение, так как оно может измениться без предупреждения.