Manual do PHP
Anterior |  | Próxima

# range

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

range -- Cria um array contendo uma faixa de elementos

## Descrição

array range ( int low, int high [, int step])

range() retorna um array com elementos de low até high, com intervalo fechado. Se low > high, será de high até low.

> Novo parâmetro: O parâmetro opcional step foi adicionado no PHP 5.0.0.

Se o parâmetro step for especificado, será usado como o incremento entre os elementos da sequência. step deve ser um inteiro positivo. Se não for especificado, step terá valor igual a 1.

Exemplo 1. range() exemplos

`<?php
// array(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ,11, 12)
foreach(range(0, 12) as $numero) {
echo $numero;
}
// O parâmetro step foi introduzido no 5.0.0
// array(0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100)
foreach(range(0, 100, 10) as $numero) {
echo $numero;
}
// Utilização da sequência de caracteres introduzidos no 4.1.0
// array('a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i');
foreach(range('a', 'i') as $letra) {
echo $letra;
}
// array('c', 'b', 'a');
foreach(range('c', 'a') as $letra) {
echo $letra;
}
?>`

> Nota: Até a versão 4.1.0, a função range() só gerava arrays de inteiros em ordem crescente. O suporte para sequências de caracteres e arrays descrescentes foi adicionado no PHP 4.1.0. Valores de sequência de caracter estão limitados para o comprimento de um. Se um comprimento maior do que um é entrado, apenas o primeiro caractere é usado.

Cuidado
Nas versões de PHP 4.1.0 até 4.3.2, range() vê strings numéricas como strings e não como inteiros. Em lugar disso, eles serão usados por sequência de caracteres. Por exemplo, "4242" é tratado como "4".

Veja também shuffle(), array_fill(), e foreach.

Anterior | Principal | Próxima
prev | Acima | reset