Ціле число (integer)

Цілим (integer) називають число, що належить множині ℤ = {..., -2, -1, 0, 1, 2, ...}.

Синтаксис

Цілі числа (int) можна вказувати в десятковій (основа 10), шістнадцятковій (основа 16), вісімковій (основа 8) або двійковій (основа 2) формах запису. Мінус-оператором можна позначити від'ємне ціле число (int).

Для вісімкової форми запису перед числом ставиться 0 (нуль). Починаючи з PHP 8.1.0, вісімковій формі запису може передувати 0o або 0O. Для шістнадцяткової форми запису перед числом ставиться 0x (нуль та латинська x). Для двійкової форми запису перед числом ставиться 0b (нуль та b).

Починаючи з PHP 7.4.0, для кращої розбірливості цілі числа можуть містити знаки підкреслення (_) між цифрами. Потім парсер PHP вилучає ці підкреслення.

Приклад #1 Запис цілого числа

<?php
$a
= 1234; // десяткове число
$a = 1_234_567; // десяткове число (починаючи з PHP 7.4.0)
$a = -123; // від'ємне десяткове число
$a = 0123; // вісімкове число (дорівнює десятковому 83)
a = 0o123; // вісімкове число (починаючи з PHP 8.1.0)
$a = 0x1A; // шістнадцяткове число (дорівнює деятковому 26)
$a = 0b11111111; // двійкове число (дорівнює деятковому 255)
?>

Формально, починаючи з PHP 8.1.0, структура цілого числа (int) є такою (раніше вісімкові префікси 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) залежить від платформи, хоча, зазвичай, максимальне значення близьке до двох мільярдів (це 32-бітне знакове). 64-бітні платформи зазвичай мають максимальне значення близьке до 9E18. PHP не підтримує беззнакові цілі числа. Розмір цілого числа містить константа PHP_INT_SIZE, максимальне значення — константа PHP_INT_MAX та мінімальне значення — константа PHP_INT_MIN.

Переповнення цілого числа

Якщо PHP стикається з числом, що виходить за межі типу int, то інтерпретує його як десятковий дріб (float). Відповідно, в операціях з результатом за межами типу int буде повертатись десятковий дріб (float).

Приклад #2 Переповнення цілого числа

<?php
$велике_число
= 50000000000000000000;
var_dump($велике_число); // float(5.0E+19)

var_dump(PHP_INT_MAX + 1); // у 32-бітних системах: 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). Здебільшого приведення не потрібне, оскільки значення буде автоматично перетворено, якщо оператор, функція чи структура контролю очікують значення типу int. Також тип значення можна перетворити на int функцією intval().

Результатом перетворення типу resource на int є унікальне число, яке призначається для ресурсу (resource) під час виконання програми.

Дивіться також: Перетворення типів.

З логічного (bool)

false буде перетворено на 0 (нуль), а true — на 1 (одиницю).

З десяткового дробу (float)

Під час перетворення 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 не має достатньої точності, щоб дати саме цілочисельний результат. Інтерпретатор про це не повідомляє!

Зауваження:

Результатом приведення спеціальних чисел NaN, Inf та -Inf до типу int є число нуль (0).

Увага

Не можна перетворювати невідомий дріб на ціле число, оскільки це може призвести до непередбачуваного результату.

<?php
echo (int) ( (0.1+0.7) * 10 ); // виводить 7!
?>

Варто переглянути застереження про точність десяткового дробу.

З рядкового (string)

Якщо рядок є числовим або починається з числа, то його можна перетворити на відповідне цілочисельне значення, а інакше — на нуль (0).

З NULL

null завжди перетворюється на нуль (0).

З інших типів

Застереження

Результат перетворення інших типів на int є невизначеним. НЕ можна покладатись на такі перетворення, оскільки їхній алгоритм може змінюватись без попереджень.

add a note

User Contributed Notes 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
6 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
4 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