(PHP 4, PHP 5)
range — Cria um array contendo uma faixa de elementos
Cria um array contendo uma faixa de elementos
low
O valor mínimo.
high
O valor máximo.
step
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.
Retorna um array de elementos de low a
high, incluindo eles. Se low > high, a seqüência
será do maior para menor.
| Versão | Descrição |
|---|---|
| 5.0.0 |
O parâmetro opcional step foi adicionado.
|
| 4.1.0 a 4.3.2 | 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 seqüência de caracteres. Por exemplo, "4242" é tratado como "4". |
| 4.1.0 | Até a versão 4.1.0, a função range() só gerava arrays de inteiros em ordem crescente. O suporte para seqüências de caracteres e arrays descrescentes foi adicionado no PHP 4.1.0. Valores de seqüência de caracter estão limitados para o comprimento de um. Se um comprimento maior do que um é entrado, apenas o primeiro caractere é usado. |
Exemplo #1 Exemplos da range()
<?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:
Veja também shuffle(), array_fill(), e foreach.