Função PHP each()
Exemplo
Retorne a chave e o valor do elemento atual e mova o ponteiro interno para frente:
<?php
$people = array("Peter", "Joe", "Glenn", "Cleveland");
print_r (each($people));
?>
Definição e uso
A função each() retorna a chave e o valor do elemento atual e move o ponteiro interno para frente.
Nota: A função each() está obsoleta no PHP 7.2.
Essa chave e valor de elemento são retornados em uma matriz com quatro elementos. Dois elementos (1 e Valor) para o valor do elemento e dois elementos (0 e Chave) para a chave do elemento.
Métodos relacionados:
- current() - retorna o valor do elemento atual em um array
- end() - move o ponteiro interno para e gera o último elemento na matriz
- next() - move o ponteiro interno para e gera o próximo elemento na matriz
- prev() - move o ponteiro interno para e gera o elemento anterior na matriz
- reset() - move o ponteiro interno para o primeiro elemento do array
Sintaxe
each(array)
Valores de parâmetro
Parameter | Description |
---|---|
array | Required. Specifies the array to use |
Detalhes técnicos
Valor de retorno: | Retorna a chave e o valor do elemento atual. Essa chave e valor de elemento são retornados em uma matriz com quatro elementos. Dois elementos (1 e Valor) para o valor do elemento e dois elementos (0 e Chave) para a chave do elemento. Esta função retorna FALSE se não houver mais elementos do array |
---|---|
Versão do PHP: | 4+ |
Registro de alterações do PHP: | Esta função foi preterida a partir do PHP 7.2 |
Mais exemplos
Exemplo
Mesmo exemplo que o da parte superior da página, mas com um loop para gerar a matriz inteira:
<?php
$people = array("Peter", "Joe", "Glenn", "Cleveland");
reset($people);
while (list($key, $val) = each($people))
{
echo "$key => $val<br>";
}
?>
Exemplo
Uma demonstração de todos os métodos relacionados:
<?php
$people = array("Peter", "Joe", "Glenn", "Cleveland");
echo current($people) . "<br>"; // The current element is Peter
echo next($people) . "<br>"; // The next element of Peter is Joe
echo current($people) . "<br>"; // Now the current element is Joe
echo prev($people) . "<br>"; // The previous element of Joe is Peter
echo end($people) . "<br>"; // The last element is Cleveland
echo prev($people) . "<br>"; // The previous element of Cleveland is Glenn
echo current($people) . "<br>"; // Now the current element is Glenn
echo reset($people) . "<br>"; // Moves the internal pointer to the first element of the array, which is Peter
echo next($people) . "<br>"; // The next element of Peter is Joe
print_r (each($people)); // Returns the key and value of the current element (now Joe), and moves the internal pointer forward
?>
❮ Referência de array PHP