Funções PHP |
. Glossários Funções PHP - range ( ) |
range
(PHP 3>= 3.0.8, PHP 4 , PHP 5)
range -- Cria um array contendo uma faixa de elementos
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:
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: 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.