Manuale PHP
IndietroAvanti

each

(PHP 3, PHP 4 )

each --  Restituisce la corrente 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);
print_r($bar);

$bar ora contiene la seguente coppia chiave/valore: 
Array
(
    [1] => bob
    [value] => bob
    [0] => 0
    [key] => 0
)
$foo = array ("Robert" => "Bob", "Seppo" => "Sepi");
$bar = each ($foo);ù
print_r($bar);

$bar ora contiene la seguente coppia chiave/valore: 
Array
(
    [1] => Bob
    [value] => Bob
    [0] => Robert
    [key] => Robert
)

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

Esempio 2. Attraversamento di $_POST con each() 

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

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(), prev() e foreach.

IndietroPartenzaAvanti
currentRisaliend