Los enteros

Un int es un número perteneciente al conjunto ℤ = {..., -2, -1, 0, 1, 2, ...}.

Sintaxis

Los ints pueden ser especificados en notación decimal (base 10), hexadecimal (base 16), octal (base 8), o binaria (base 2). El operador de negación puede ser utilizado para designar un int negativo.

Para utilizar la notación octal, preceda el número de un 0 (cero). A partir de PHP 8.1.0, la notación octal puede ser precedida con 0o o 0O. Para utilizar la notación hexadecimal, preceda el número de 0x. Para utilizar la notación binaria, preceda el número de 0b.

A partir de PHP 7.4.0, los enteros literales pueden contener underscores (_) entre los dígitos, para una mejor legibilidad de los literales. Estos underscores son eliminados por el escáner de PHP.

Ejemplo #1 Los enteros literales

<?php
$a
= 1234; // un número decimal
$a = 0123; // un número octal (equivalente a 83 en decimal)
$a = 0o123; // un número octal (a partir de PHP 8.1.0)
$a = 0x1A; // un número hexadecimal (equivalente a 26 en decimal)
$a = 0b11111111; // un número binario (equivalente a 255 en decimal)
$a = 1_234_567; // un número decimal (a partir de PHP 7.4.0)
?>

Formalmente, la estructura de un entero literal es a partir de PHP 8.1.0 (anteriormente, los prefijos octales 0o o 0O no estaban permitidos, y antes de PHP 7.4.0, los underscores no estaban permitidos.

decimal     : [1-9][0-9]*(_[0-9]+)*
            | 0

hexadecimal : 0[xX][0-9a-fA-F]+(_[0-9a-fA-F]+)*

octal       : 0[oO]?[0-7]+(_[0-7]+)*

binary      : 0[bB][01]+(_[01]+)*

integer     : decimal
            | hexadecimal
            | octal
            | binary

El tamaño de un int es dependiente de la plataforma, sin embargo, un valor máximo de aproximadamente 2 mil millones es habitual (esto corresponde a 32 bits con signo). Las plataformas de 64 bits tienen habitualmente un valor máximo de aproximadamente 9E18. PHP no soporta los ints sin signo. El tamaño de un int puede ser determinado utilizando la constante PHP_INT_SIZE, el valor máximo, utilizando la constante PHP_INT_MAX, y el valor mínimo utilizando la constante PHP_INT_MIN.

Desbordamiento de entero

Si PHP encuentra un número superior al máximo de un int, será interpretado como un float. De la misma manera, una operación que resulte en un número fuera del rango del tipo int devolverá un float.

Ejemplo #2 Desbordamiento de entero en un sistema de 32 bits

<?php

$large_number
= 50000000000000000000;
var_dump($large_number); // float(5.0E+19)
var_dump(PHP_INT_MAX + 1); // sistema de 32 bits: float(2147483648)
// sistema de 64 bits: float(9.2233720368548E+18)
?>

División de entero

No hay operador de división de int en PHP, para lograr esto utilizar la función intdiv(). 1/2 produce el float (0.5). El valor puede ser convertido en un int para redondear hacia cero, o utilizando la función round() para tener un control más fino sobre cómo se realiza el redondeo.

Ejemplo #3 División

<?php
var_dump
(25/7); // float(3.5714285714286)
var_dump((int) (25/7)); // int(3)
var_dump(round(25/7)); // float(4)
?>

Conversión en entero

Para convertir explícitamente un valor en un int, utilizar la palabra clave (int), o (integer). Sin embargo, en la mayoría de los casos, esta palabra clave no es necesaria ya que un valor será automáticamente convertido si un operador, una función o una estructura de control requiere un int como argumento. Un valor puede también ser convertido en un int utilizando la función intval().

Si un recurso es convertido a un int, entonces el resultado será el identificador único del recurso asignado por PHP en la ejecución.

Ver también el transtipado.

Desde un booléen

false corresponde a 0 (cero), y true corresponde a 1 (uno).

Desde un número de coma flotante

Al convertir un float en int, el número es redondeado hacia cero. A partir de PHP 8.1.0, se emite una notificación de deprecación al realizar la conversión implícita de un float no integral en int perdiendo precisión.

Ejemplo #4 Conversión desde números flotantes

<?php

function foo($value): int {
return
$value;
}

var_dump(foo(8.1)); // "Deprecated: Implicit conversion from float 8.1 to int loses precision" a partir de PHP 8.1.0
var_dump(foo(8.1)); // Antes de PHP 8.1.0
var_dump(foo(8.0)); // 8 en ambos casos

var_dump((int) 8.1); // 8 en ambos casos
var_dump(intval(8.1)); // 8 en ambos casos
?>

Si el número de coma flotante está más allá de los límites de los ints (habitualmente, +/- 2.15e+9 = 2^31 en plataformas de 32 bits y +/- 9.22e+18 = 2^63 en plataformas de 64 bits), el resultado será indefinido, ya que el float no tiene suficiente precisión para dar un resultado int exacto. ¡No se emite ninguna alerta cuando ocurre este comportamiento!

Nota:

NaN, Infinity y -Inf son siempre igual a cero al convertir en int.

Advertencia

Nunca convierta una fracción desconocida en un int, esto puede generar resultados inesperados.

<?php
echo (int) ( (0.1+0.7) * 10 ); // Muestra 7 !
?>

Ver también la sección sobre las alertas concernientes a la precisión de los números de coma flotante.

Desde cadenas de caracteres

Si una cadena es numérica o numérica de cabeza entonces será transformada en su valor entero correspondiente, de lo contrario será convertida a cero (0).

Desde NULL

null es siempre convertido en cero (0).

Desde otros tipos

Precaución

El comportamiento de la conversión en int es indefinido desde otros tipos. No reportar ningún comportamiento observado, sabiendo que pueden cambiar sin previo aviso.

add a note

User Contributed Notes 10 notes

up
135
php at richardneill dot org
12 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
16
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
7 years ago
"There is no integer division operator in PHP". But since PHP 7, there is the intdiv function.
up
17
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
13
Anonymous
18 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
18 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
1
lewismoten at gmail dot com
10 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
7
Anonymous
10 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
3
litbai
9 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.
To Top