each

each -- Retorna o par chave/valor corrente de um array e avança o seu cursor

Descrição

array each ( array array)

Retorna o par chave / valor corrente de array e avança o seu cursor . Esse par é retornado num array de quatro elementos , com as chaves 0 , 1 , key , e value . Os elementos 0 e key contêm o nome da chave do elemento do array , e 1 e value contêm o valor .

Se o cursor interno do array estiver apontando para além do final do array , each( ) retorna FALSE .

Exemplo 1 . Exemplos de each( )




$bar agora contém os seguintes pares de chaves e valores :



  • $bar agora contém os seguintes pares de chaves e valores :

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




    each( ) é tipicamente usada em conjunto com list( ) para percorrer um array ; por exemplo , $_POST :

    Exemplo 2 . Percorrendo $HTTP_POST_VARS usando each( )

     
    echo
    
     
    "
    
     
    Valores
    
     
    submetidos
    
     
    pelo
    
     
    método
    
     
    POST
    
     
    :
    
     
    br
    
     
    "
    
     
    ;
    
     
    reset
    
     
    ($_POST)
    
     
    ;
    
     
    while
    
     
    (list
    
     
    ($chave
    
     
    ,
    
     
    $valor
    
     
    )
    
     
    =
    
     
    each
    
     
    ($_POST)
    
     
    )
    
     
    {
    
     
    echo
    
     
    "$chave
    
     
    =
    
     
    $valor
    
     
    br
    
     
    "
    
     
    ;
    
     
    }
    
    
    
    


    Depois da execução de each( ) , o cursor interno do array vai apontar para o prócimo elemento do array , ou no último elemento se ele chegar ao final do array . Você deve usar reset( ) se quiser percorrer o array novamente .

    Veja também key( ) , list( ) , current( ) , reset( ) , next( ) , prev( ) e foreach .