Funkcja PHP range() tworzy i zwraca tablicę zawierającą pewien zakres elementów.
Składnia funkcji PHP range()
Funkcja PHP range() ma następującą składnię:
range(string|int|float $start, string|int|float $end, int|float $step = 1): arrayParametry
| Parametr | Opis |
|---|---|
| start | Parametr obowiązkowy. Wartość początkowa sekwencji. Jeśli jest większa od wartości końcowej, to zostaje utworzona sekwencja rosnąca. Jeśli jest mniejsza od końcowej, to zostaje utworzona sekwencja malejąca. |
| end | Parametr obowiązkowy. Ostatnia dopuszczalna wartość sekwencji. Nie zawsze musi zostać użyta. Jeśli na przykład zostanie ustawiony zakres od 1 do 10 z krokiem co 3, to ostatnią wartością sekwencji będzie 9. |
| step | Odstęp między każdą parą sąsiadujących wartości w sekwencji. Jeśli ma wartość ujemną, to zostaje utworzona sekwencja malejąca. A jeśli ma wartość typu float bez części ułamkowej, to jest interpretowany jako wartość typu int.
Uwaga: jesli parametr step ma wartość ujemną, a definicja sekwencji jest rosnąca, np. od 1 do 10, to funkcja range() zgłosi błąd ValueError. |
Wartość zwrotna
Funkcja PHP range() zwraca tablicę zawierającą sekwencję wartości zdefiniowaną przez jej argumenty wywołania.
Jeśli parametry start i end mają wartości łańcuchowe, a parametr step ma wartość int, to funkcja range() zwraca sekwencję bajtów reprezentujących znaki ASCII z zakresu alfabetu łacińskiego.
Jeśli którykolwiek z parametrów ma wartość typu float, to zwrócona zostaje sekwencja elementów typu float.
W innych przypadkach zwracana jest sekwencja wartości typu int.
