Podręcznik PHP
Poprzedni		Następny

range

(PHP 3 >= 3.0.8, PHP 4, PHP 5)

range -- Stwórz tablicę zawierającą przedział elementów

Opis

array range ( mixed dolny, mixed górny [, number krok] )

range() zwraca tablicę elementów od dolny do górny, włącznie. Jeśli dolny > górny, to sekwencja będzie od górnego do dolnego.

Nowy parametr: Parametr opcjonalny krok został dodany w PHP 5.0.0.

Jeśli podany zostanie parametr krok, zostanie on użyty jako różnica pomiędzy elementami w sekwencji. krok powinien być liczbą dodatnią. Jeśli nie zostanie on podany, krok przyjmie domyślną wartość 1.

Przykład 1. Przykłady użycia funkcji range()

<?php
// array(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12)

                foreach (range(0, 12) as $liczba) {

                    echo $liczba;

                }

                
// Parametr kroku został wprowadzony w 5.0.0


                // array(0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100)

                foreach (range(0, 100, 10) as $liczba) {

                    echo $liczba;    

                }

                
// Użycie sekwencji znakowych wprowadzono w 4.1.0


                // array('a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i');

                foreach (range('a', 'i') as $litera) {

                    echo $litera;

                }

                
// array('c', 'b', 'a');
foreach (range('c', 'a') as $litera) {


                    echo $litera;

                }  
?>

Notatka: W wersjach wcześniejszych od PHP 4.1.0 funkcja range() generowała tylko rosnące tablice liczbowe. Obsługa sekwencji znakowych i tablic malejących została wprowadzona w PHP 4.1.0. Wartości sekwencji znakowych są ograniczone do długości jednego znaku. Jeśli wprowadzony zostanie ciąg długości większej niż jeden, użyty zostanie tylko pierwszy znak.

Uwaga!

W wersjach PHP od 4.1.0 do 4.3.2 funkcja range() rozpoznawała ciągi numeryczne jako ciągi, a nie jako liczby. W związku z tym będą one użyte do generowania sekwencji znakowych. Na przykład "4242" będzie traktowane jako "4".

Patrz także: shuffle(), array_fill() i foreach.

Poprzedni	Spis treści	Następny
prev	Początek rozdziału	reset