PHP 8.1.31 Released!

Целые числа

Тип 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 из других типов нет определения. Нельзя полагаться на наблюдаемое поведение, поскольку оно изменится в новых версиях языка без предупреждения.

Добавить

Примечания пользователей 11 notes

up
138
php at richardneill dot org
11 years ago
A leading zero in a numeric literal means "this is octal". But don't be confused: a leading zero in a string does not. Thus:
$x = 0123; // 83
$y = "0123" + 0 // 123
up
56
d_n at NOSPAM dot Loryx dot com
17 years ago
Here are some tricks to convert from a "dotted" IP address to a LONG int, and backwards. This is very useful because accessing an IP addy in a database table is very much faster if it's stored as a BIGINT rather than in characters.

IP to BIGINT:
<?php
$ipArr
= explode('.',$_SERVER['REMOTE_ADDR']);
$ip = $ipArr[0] * 0x1000000
+ $ipArr[1] * 0x10000
+ $ipArr[2] * 0x100
+ $ipArr[3]
;
?>

IP as BIGINT read from db back to dotted form:

Keep in mind, PHP integer operators are INTEGER -- not long. Also, since there is no integer divide in PHP, we save a couple of S-L-O-W floor (<division>)'s by doing bitshifts. We must use floor(/) for $ipArr[0] because though $ipVal is stored as a long value, $ipVal >> 24 will operate on a truncated, integer value of $ipVal! $ipVint is, however, a nice integer, so
we can enjoy the bitshifts.

<?php
$ipVal
= $row['client_IP'];
$ipArr = array(0 =>
floor( $ipVal / 0x1000000) );
$ipVint = $ipVal-($ipArr[0]*0x1000000); // for clarity
$ipArr[1] = ($ipVint & 0xFF0000) >> 16;
$ipArr[2] = ($ipVint & 0xFF00 ) >> 8;
$ipArr[3] = $ipVint & 0xFF;
$ipDotted = implode('.', $ipArr);
?>
up
17
ganlvtech at qq dot com
4 years ago
Be aware of float to int cast overflow

<?php

// You may expected these
var_dump(0x7fffffffffffffff); // int(9223372036854775807)
var_dump(0x7fffffffffffffff + 1); // float(9.2233720368548E+18)
var_dump((int)(0x7fffffffffffffff + 1)); // int(9223372036854775807)
var_dump(0x7fffffffffffffff + 1 > 0); // bool(true)
var_dump((int)(0x7fffffffffffffff + 1) > 0); // bool(true)
var_dump((int)'9223372036854775807'); // int(9223372036854775807)
var_dump(9223372036854775808); // float(9.2233720368548E+18)
var_dump((int)'9223372036854775808'); // int(9223372036854775807)
var_dump((int)9223372036854775808); // int(9223372036854775807)

// But actually, it likes these
var_dump(0x7fffffffffffffff); // int(9223372036854775807)
var_dump(0x7fffffffffffffff + 1); // float(9.2233720368548E+18)
var_dump((int)(0x7fffffffffffffff + 1)); // int(-9223372036854775808) <-----
var_dump(0x7fffffffffffffff + 1 > 0); // bool(true)
var_dump((int)(0x7fffffffffffffff + 1) > 0); // bool(false) <-----
var_dump((int)'9223372036854775807'); // int(9223372036854775807)
var_dump(9223372036854775808); // float(9.2233720368548E+18)
var_dump((int)'9223372036854775808'); // int(9223372036854775807)
var_dump((int)9223372036854775808); // int(-9223372036854775808) <-----

?>

These overflows are dangerous when you try to compare it with zero, or substract it from another value (e.g. money).
up
21
egwayjen at gmail dot com
6 years ago
"There is no integer division operator in PHP". But since PHP 7, there is the intdiv function.
up
18
dhairya lakhera
7 years ago
-------------------------------------------------------------------------
Question :
var_dump((int) 010); //Output 8

var_dump((int) "010"); //output 10

First one is octal notation so the output is correct. But what about the when converting "010" to integer. it should be also output 8 ?
--------------------------------------------------------------------------
Answer :

Casting to an integer using (int) will always cast to the default base, which is 10.

Casting a string to a number this way does not take into account the many ways of formatting an integer value in PHP (leading zero for base 8, leading "0x" for base 16, leading "0b" for base 2). It will simply look at the first characters in a string and convert them to a base 10 integer. Leading zeroes will be stripped off because they have no meaning in numerical values, so you will end up with the decimal value 10 for (int)"010".

Converting an integer value between bases using (int)010 will take into account the various ways of formatting an integer. A leading zero like in 010 means the number is in octal notation, using (int)010 will convert it to the decimal value 8 in base 10.

This is similar to how you use 0x10 to write in hexadecimal (base 16) notation. Using (int)0x10 will convert that to the base 10 decimal value 16, whereas using (int)"0x10" will end up with the decimal value 0: since the "x" is not a numerical value, anything after that will be ignored.

If you want to interpret the string "010" as an octal value, you need to instruct PHP to do so. intval("010", 8) will interpret the number in base 8 instead of the default base 10, and you will end up with the decimal value 8. You could also use octdec("010") to convert the octal string to the decimal value 8. Another option is to use base_convert("010", 8, 10) to explicitly convert the number "010" from base 8 to base 10, however this function will return the string "8" instead of the integer 8.

Casting a string to an integer follows the same the logic used by the intval function:

Returns the integer value of var, using the specified base for the conversion (the default is base 10).
intval allows specifying a different base as the second argument, whereas a straight cast operation does not, so using (int) will always treat a string as being in base 10.

php > var_export((int) "010");
10
php > var_export(intval("010"));
10
php > var_export(intval("010", 8));
8
up
3
lewismoten at gmail dot com
5 months ago
Regarding the part about `PHP does not support unsigned ints`, this often causes much confusion when using the hard-coded minimum value of a signed integer that matches PHP_INT_MIN.

<?php
// 64-bit example
var_dump(PHP_INT_MIN);
var_dump(-9223372036854775808);
var_dump(PHP_INT_MIN === -9223372036854775808);
// int(-9223372036854775808)
// float(-9.223372036854776E+18)
// bool(false)
?>

Although visually, I've typed the same value that PHP_INT_MIN writes out `-9223372036854775808`, the language parser only understands it as two expressions with a negate operator followed by `9223372036854775808`. The value exceeds the maximum value of an integer by one, and is promoted to a float. Although it's been suggested in the past to wire up a hook to look for this value specifically, it's more difficult than it sounds. The tokenizer is unable to evaluate both the negate and integer as one token. In addition, you would also need to address binary, octal, and hex literals.

<?php
var_dump
(-9223372036854775808); // literal decimal
var_dump(-0x8000000000000000); // literal hex
var_dump(-0b1000000000000000000000000000000000000000000000000000000000000000); // literal binary
var_dump(-01000000000000000000000); // literal octal
?>

If you need to hard-code the minimum value, use `PHP_INT_MIN`. It was introduced specifically for this edge case. Alternative methods are to write `-9223372036854775807 - 1`.
up
12
Anonymous
17 years ago
To force the correct usage of 32-bit unsigned integer in some functions, just add '+0' just before processing them.

for example
echo(dechex("2724838310"));
will print '7FFFFFFF'
but it should print 'A269BBA6'

When adding '+0' php will handle the 32bit unsigned integer
correctly
echo(dechex("2724838310"+0));
will print 'A269BBA6'
up
13
rustamabd@gmail-you-know-what
17 years ago
Be careful with using the modulo operation on big numbers, it will cast a float argument to an int and may return wrong results. For example:
<?php
$i
= 6887129852;
echo
"i=$i\n";
echo
"i%36=".($i%36)."\n";
echo
"alternative i%36=".($i-floor($i/36)*36)."\n";
?>
Will output:
i=6.88713E+009
i%36=-24
alternative i%36=20
up
7
Anonymous
9 years ago
Converting to an integer works only if the input begins with a number
(int) "5txt" // will output the integer 5
(int) "before5txt" // will output the integer 0
(int) "53txt" // will output the integer 53
(int) "53txt534text" // will output the integer 53
up
5
litbai
8 years ago
<?php
$ipArr
= explode('.', $ipString);
$ipVal = ($ipArr[0] << 24)
+ (
$ipArr[1] << 16)
+ (
$ipArr[2] << 8)
+
$ipArr[3]
;
?>
1. the priority of bit op is lower than '+',so there should be brackets.
2. there is no unsighed int in PHP, if you use 32 bit version,the code above will get negative result when the first position of IP string greater than 127.
3. what the code actually do is calculate the integer value of transformed 32 binary bit from IP string.
up
-3
Jacek
17 years ago
On 64 bits machines max integer value is 0x7fffffffffffffff (9 223 372 036 854 775 807).
To Top