range

(PHP 4, PHP 5, PHP 7, PHP 8)

rangeCrée un tableau contenant un intervalle d'éléments

Description

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

Crée un tableau contenant un intervalle d'éléments.

Si à la fois start et end sont des string, et que step est de type int, le tableau produit sera une séquence d'octets. Sinon, le tableau produit sera une séquence de nombres.

La séquence est croissante si start est inférieur ou égal à end. Sinon, la séquence est décroissante.

Liste de paramètres

start

Première valeur de la séquence.

end

Dernière valeur possible de la séquence.

step

step indique de combien la séquence produite progresse entre les valeurs de la séquence.

step peut être négatif pour les séquences décroissantes.

Si step est un float sans partie fractionnaire, il est interprété comme un int.

Valeurs de retour

Retourne une séquence d'éléments sous forme d'un tableau array avec le premier élément étant start allant jusqu'à end, chaque valeur de la séquence étant séparée de step valeurs.

Le dernier élément du tableau retourné est soit end soit l'élément précédent de la séquence, en fonction de la valeur de step.

Si à la fois start et end sont des string, et que step est de type int le tableau produit sera une séquence d'octets, généralement des caractères ASCII latins.

Si au moins l'un des start, end ou step est de type float, le tableau produit sera une séquence de float.

Sinon, le tableau produit sera une séquence de int.

Erreurs / Exceptions

  • Si step est égal à 0, une ValueError est générée.

  • Si start, end, ou step ne sont pas is_finite(), une ValueError est générée.

  • Si step est négatif, mais la plage produite est croissante (c'est-à-dire $start <= $end), une ValueError est générée.

  • Si start ou end est la chaîne vide