array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.range.php', 1 => 'range', 2 => 'Cria um array contendo uma faixa de elementos', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Funções para Array', ), 'prev' => array ( 0 => 'function.prev.php', 1 => 'prev', ), 'next' => array ( 0 => 'function.reset.php', 1 => 'reset', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/array/functions/range.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

range

(PHP 4, PHP 5, PHP 7, PHP 8)

range — Cria um array contendo uma faixa de elementos

Descrição

range(string|int|float $start, string|int|float $end, int|float $step = 1): array

Cria um array contendo uma faixa de elementos.

Se ambos start e end forem strings, e step é int, o array produzido será uma sequência de bytes. Em outros casos, o array produzido será uma sequência de números.

A sequência é crescente se start é menor ou igual a end. Em outros casos, a sequência é decrescente.

Parâmetros

start

O primeiro valor da sequência.

end

O último valor possível da sequência.

step

step indica o tamanho do deslocamento entre os os valores produzidos na sequência.

step pode ser negativo em sequências decrescentes.

Se step é um float sem uma parte fracional, ele é interpretado como int.

Valor Retornado

Retorna uma sequência de elementos como um array onde o primeiro elemento é start progredindo a até end, com cada valor da sequência separados por step valores.

O último elemento do array retornado pode ser end ou um valor anterior da sequência, a depender do valor de step.

Se ambos start e end são strings, e step é int, o array produzido será uma sequẽncia de bytes, geralmente as letras latinas no padrão ASCII.

Se start, end, ou step forem float, o array produzido será uma sequẽncia de floats.

Em outros casos, o array produzido será uma sequência de int.

Erros/Exceções

Registro de Alterações

Versão Descrição
8.3.0 Se ambos start e end forem strings então range() nem sempre produzirá um array de bytes. Anteriormente, se um dos valores limite for uma string numérica, então o outro valor string é implicitamente convertido para um int.
8.3.0 Um aviso E_WARNING agora é emitido se start ou end é uma string implicitamente conversível para int se quaisquer valores limite é interpretado como um número.
8.3.0 Um aviso E_WARNING agora é emitido se start ou end é uma string não numérica com mais de um byte.
8.3.0 Um aviso E_WARNING agora é emitido se start ou end é uma string vazia.
8.3.0 Se step é um float sem parte fracionária, ele será interpretado como um int.
8.3.0 Um erro ValueError agora é lançado se step é negativo quando da produção de um array crescente.
8.3.0 Um erro ValueError agora é lançado se step não for finito.
8.3.0 Um erro TypeError agora é lançado se start ou end é um array, object ou resource. Anteriormente eles eram implicitamente convertidos para int.

Exemplos

Exemplo #1 Exemplos de range()

<?php
echo implode(', ', range(0, 12)), PHP_EOL;

echo implode(', ', range(0, 100, 10)), PHP_EOL;

echo implode(', ', range('a', 'i')), PHP_EOL;

echo implode(', ', range('c', 'a')), PHP_EOL;

echo implode(', ', range('A', 'z')), PHP_EOL;
?>

O exemplo acima produzirá:

0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12
0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100
a, b, c, d, e, f, g, h, i
c, b, a
A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z, [, \, ], ^, _, `, a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z

Veja Também