intdiv

(PHP 7, PHP 8)

intdiv — División de Enteros

Descripción

function intdiv(int $num1, int $num2): int

Devuelve el cociente entero de la división de num1 por num2.

Parámetros

num1: Número a dividir.
num2: Número que divide num1.

Valores devueltos

El cociente entero de la división de num1 por num2.

Errores/Excepciones

Si num2 es 0, se emitirá una excepción DivisionByZeroError . Si num1 es PHP_INT_MIN y num2 es -1, en este caso se emite una excepción ArithmeticError .

Ejemplos

Ejemplo #1 Ejemplo de intdiv()

<?php
var_dump(intdiv(3, 2));
var_dump(intdiv(-3, 2));
var_dump(intdiv(3, -2));
var_dump(intdiv(-3, -2));
var_dump(intdiv(PHP_INT_MAX, PHP_INT_MAX));
var_dump(intdiv(PHP_INT_MIN, PHP_INT_MIN));
?>

El ejemplo anterior mostrará:

int(1)
int(-1)
int(-1)
int(1)
int(1)
int(1)

Ejemplo #2 Ejemplo de intdiv() con un divisor inválido

<?php
try {
 intdiv(PHP_INT_MIN, -1);
} catch (Error $e) {
 echo get_class($e), ': ', $e->getMessage(), PHP_EOL;
}
try {
 intdiv(1, 0);
} catch (Error $e) {
 echo get_class($e), ': ', $e->getMessage(), PHP_EOL;
}
?>

El ejemplo anterior mostrará:

ArithmeticError: Division of PHP_INT_MIN by -1 is not an integer
DivisionByZeroError: Division by zero

Véase también

/ - División de número flotante
% - Módulo entero
fmod() - Devuelve el resto de la división - Módulo de número flotante

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

+add a note

User Contributed Notes 2 notes

down

AmeenRoss ¶

11 years ago

This does indeed seem to be equal to intdiv:
<?php
function intdiv_1($a, $b){
 return ($a - $a % $b) / $b;
}
?>

However, this isn't:
<?php
function intdiv_2($a, $b){
 return floor($a / $b);
}
?>

Consider an example where either of the parameters is negative:
<?php
$param1 = -10;
$param2 = 3;
print_r([
 'modulus' => intdiv_1($param1, $param2),
 'floor' => intdiv_2($param1, $param2),
]);
/**
 * Array
 * (
 * [modulus] => -3
 * [floor] => -4
 * )
 */
?>

down

oittaa ¶

4 years ago

Python style integer division, where the result is always rounded towards minus infinity.
1 // 2 is 0
(-1) // 2 is -1
1 // (-2) is -1
(-1) // (-2) is 0
<?php
function intdiv_py(int $num1, int $num2): int{
 if ($num1 < 0 xor $num2 < 0){
 $num1 = abs($num1);
 $num2 = abs($num2);
 $remainder = $num1 % $num2;
 return $remainder ? -1 -($num1 - $remainder) / $num2 : -$num1 / $num2;
 }
 return intdiv($num1, $num2);
}
var_dump(intdiv_py(1, 2)); // 0
var_dump(intdiv_py(-1, 2)); // -1
var_dump(intdiv_py(1, -2)); // -1
var_dump(intdiv_py(-1, -2)); // 0
?>

+add a note