Forum und email

range

(PHP 4, PHP 5)

range — Cria um array contendo uma faixa de elementos

Descrição

array range ( mixed $low , mixed $high [, number $step ] )

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

Nota: 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.

Example#1 range() exemplos

<?php  
  
// array(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ,11, 12)  
foreach(range(012) 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(010010) 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.