Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / PHP

range()

Crée un tableau contenant une suite croissante ou décroissante.

Version : PHP 8.4; repository runtime, production runtime not attested

Syntaxe

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

Crée un tableau contenant une suite croissante ou décroissante. La borne finale ne figure que si le pas la rencontre exactement. Des lettres d’un octet produisent une suite de caractères. Un pas nul provoque ValueError et un grand intervalle occupe la mémoire de tous ses éléments. Depuis PHP 8.3 deux bornes textuelles d’un octet, même des chiffres, produisent des chaînes. Un pas négatif en ordre croissant provoque ValueError. Des chaînes non numériques plus longues produisent E_WARNING et seuls leurs premiers octets comptent.

Signature

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

Sortie de l’exemple

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

Exemples

<?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]);

Résultat

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

Sources