Função each() do PHP
Exemplo
Retorna o nome e o valor do elemento atual e move o ponteiro para frente:
<?php
$people = array("Bill", "Steve", "Mark", "David");
print_r (each($people));
?>
Definição e uso
A função each() retorna o nome e o valor do elemento atual e move o ponteiro para frente.
O nome e o valor do elemento serão retornados em um array de quatro elementos. Dois elementos (1 e Value) contêm o valor, dois elementos (0 e Key) contêm o nome da chave.
Métodos relacionados:
- current() - Retorna o valor do elemento atual do array
- end() - Aponta o ponteiro interno para o último elemento do array e imprime
- next() - Aponta o ponteiro interno para o próximo elemento do array e imprime
- prev() - Aponta o ponteiro interno para o elemento anterior do array e imprime
- reset() - Aponta o ponteiro interno para o primeiro elemento do array e imprime
Sintaxe
each(array)
| Parâmetros | Descrição |
|---|---|
| array | Obrigatório. Especifica o array a ser usado. |
Descrição
A função each() gera um array composto pelo nome e valor do elemento atual apontado pelo ponteiro interno e move o ponteiro para frente.
O array retornado inclui os quatro elementos: nome da chave 0, 1, key e value. O item 0 e key contêm o nome da chave do item do array, 1 e value contêm os dados.
Se o ponteiro interno passar do limite do array, a função retornará FALSE.
Detalhes técnicos
| Retorno: |
Retorna o nome e o valor do elemento atual. O nome e o valor do elemento atual são retornados em um array de quatro elementos. Dois elementos (1 e Value) contêm o valor, dois elementos (0 e Key) contêm o nome da chave. Se não há mais elementos no array, a função retorna FALSE. |
| Versão do PHP: | 4+ |
Mais exemplos
Exemplo 1
É idêntico ao exemplo superior da página, mas neste caso, o loop imprime todo o array:
<?php
$people = array("Bill", "Steve", "Mark", "David");
reset($people);
enquanto (list($key, $val) = each($people))
{
echo "$key => $val<br>";
}
?>
Exemplo 2
Demonstrar todos os métodos relacionados:
<?php
$people = array("Bill", "Steve", "Mark", "David");
echo current($people) . "<br>"; // O elemento atual é Bill
echo next($people) . "<br>"; // O próximo elemento de Bill é Steve
echo current($people) . "<br>"; // O elemento atual é Steve
echo prev($people) . "<br>"; // O elemento anterior a Steve é Bill
echo end($people) . "<br>"; // O último elemento é David
echo prev($people) . "<br>"; // O elemento anterior a David é Mark
echo current($people) . "<br>"; // O elemento atual é Mark
echo reset($people) . "<br>"; // Move o ponteiro interno para o primeiro elemento do array, ou seja, Bill
echo next($people) . "<br>"; // O próximo elemento de Bill é Steve
print_r (each($people); // Retorna o nome e o valor do elemento atual (atualmente é Steve) e move o ponteiro interno
?>
