Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / PHP

range()

Crea un array con una secuencia ascendente o descendente.

Versión: PHP 8.4; repository runtime, production runtime not attested

Sintaxis

range(string|int|float $start, string|int|float $end, int|float $step = 1): array

Crea un array con una secuencia ascendente o descendente. El extremo final aparece solo si el paso lo alcanza exactamente. Letras de un byte producen una secuencia de caracteres. El paso cero provoca ValueError y un intervalo grande reserva memoria para todos los elementos. Desde PHP 8.3 dos límites de texto de un byte, incluso dígitos, producen cadenas. Un paso negativo en un intervalo ascendente provoca ValueError. Las cadenas no numéricas más largas producen E_WARNING y solo cuentan sus primeros bytes.

Firma

range(string|int|float $start, string|int|float $end, int|float $step = 1): array

Salida del ejemplo

[[5,3,1],["a","c","e"]]
ValueError
[["3","4","5"],["a"],[true,true],"ValueError"]

Ejemplos

<?php
echo json_encode([range(5,0,2),range("a","e",2)]), PHP_EOL;
try { range(1,2,0); } catch (ValueError $e) { echo "ValueError"; }
$warnings=[]; set_error_handler(function($n) use (&$warnings){$warnings[]=$n===E_WARNING;return true;});
$bytes=range("ab","ac"); restore_error_handler();
try{range(1,5,-2);}catch(ValueError $e){$negative=get_class($e);}
echo PHP_EOL,json_encode([range("3","5"),$bytes,$warnings,$negative]);

Resultado

[[5,3,1],["a","c","e"]]
ValueError
[["3","4","5"],["a"],[true,true],"ValueError"]

Fuentes