each

(PHP 3, PHP 4 >= 4.0.0)

each --  Restituisce la successiva coppia chiave/valore di un array e incrementa il puntatore dell'array

Descrizione

array each (array array)

Restituisce la corrente coppia chiave/valore corrente di array e incrementa il puntatore interno dell'array. Questa coppia è restituita in un array di quattro elementi, con le chiavi 0, 1, key, and value. Gli elementi 0 e key contengono il nome della chiave dell'elemento dell'array, mentre 1 e value contengono i dati.

Se il puntatore interno dell'array punta oltre la fine dei contenuti dell'array, each() restituisce FALSE.

Esempio 1. esempi dieach()


$foo = array ("bob", "fred", "jussi", "jouni", "egon", "marliese");
$bar = each ($foo);
      

$bar ora contiene la seguente coppia chiave/valore:

  • 0 => 0
  • 1 => 'bob'
  • key => 0
  • value => 'bob'

$foo = array ("Robert" => "Bob", "Seppo" => "Sepi");
$bar = each ($foo);
       

$bar ora contiene la seguente coppia chiave/valore:

  • 0 => 'Robert'
  • 1 => 'Bob'
  • key => 'Robert'
  • value => 'Bob'

each() viene normalmente usata in congiunzione con list() nell'attraversamento di un array; per esempio, $HTTP_POST_VARS:

Esempio 2. Attraversamento di $HTTP_POST_VARS con each()


echo "Valori inviati con il metodo POST:<br>";
reset ($HTTP_POST_VARS);
while (list ($chiave, $valore) = each ($HTTP_POST_VARS)) {
    echo "$chiave => $valore<br>";
}
      

Dopo l'esecuzione di each(), il puntatore dell'array viene lasciato sull'elemento successivo, o sull'ultimo elemento se si è alla fine dell'array. Si deve utilizzare reset() se si vuole riattraversare l'array usando each().

Vedere anche key(), list(), current(), reset(), next(), e prev().