Hay DOS usos para el token PHP de puntos suspensivos (...); piense en ellos como empaquetar una matriz y desempaquetar una matriz. Ambos propósitos se aplican a los argumentos de funciones.
Paquete
Al definir una función, si necesita un número dinámico de variables proporcionadas a la función (es decir, no sabe cuántos argumentos se proporcionarán a esa función cuando se llame en el código) use el token de puntos suspensivos (...) para capturar todos los argumentos restantes proporcionados a esa función en una matriz que sea accesible dentro del bloque de funciones. El número de argumentos dinámicos capturados por puntos suspensivos (...) puede ser cero o más.
Por ejemplo :
// function definition
function sum(...$numbers) { // use ellipsis token when defining function
$acc = 0;
foreach ($numbers as $nn) {
$acc += $nn;
}
return $acc;
}
// call the function
echo sum(1, 2, 3, 4); // provide any number of arguments
> 10
// and again...
echo sum(1, 2, 3, 4, 5);
> 15
// and again...
echo sum();
> 0
Cuando se usa el empaquetado en la creación de instancias de funciones, la elipsis (...) captura todos los argumentos restantes , es decir, aún puede tener cualquier número de argumentos iniciales fijos (posicionales):
function sum($first, $second, ...$remaining_numbers) {
$acc = $first + $second;
foreach ($remaining_numbers as $nn) {
$acc += $nn;
}
return $acc;
}
// call the function
echo sum(1, 2); // provide at least two arguments
> 3
// and again...
echo sum(1, 2, 3, 4); // first two are assigned to fixed arguments, the rest get "packed"
> 10
Deshacer
Alternativamente, al llamar a una función, si los argumentos que le proporcionas a esa función se han combinado previamente en una matriz, usa el token de puntos suspensivos (...) para convertir esa matriz en argumentos individuales proporcionados a la función; cada elemento de la matriz se asigna a la respectiva variable de argumento de función nombrada en la definición de función.
Por ejemplo:
function add($aa, $bb, $cc) {
return $aa + $bb + $cc;
}
$arr = [1, 2, 3];
echo add(...$arr); // use ellipsis token when calling function
> 6
$first = 1;
$arr = [2, 3];
echo add($first, ...$arr); // used with positional arguments
> 6
$first = 1;
$arr = [2, 3, 4, 5]; // array can be "oversized"
echo add($first, ...$arr); // remaining elements are ignored
> 6
El desempaquetado es particularmente útil cuando se utilizan funciones de matriz para manipular matrices o variables.
Por ejemplo, desempaquetando el resultado de array_slice :
function echoTwo ($one, $two) {
echo "$one\n$two";
}
$steaks = array('ribeye', 'kc strip', 't-bone', 'sirloin', 'chuck');
// array_slice returns an array, but ellipsis unpacks it into function arguments
echoTwo(...array_slice($steaks, -2)); // return last two elements in array
> sirloin
> chuck