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