Manual do PHP
Anterior |  | Próxima

# current

(PHP 3, PHP 4 , PHP 5)

current -- Retorna o elemento corrente em um array

## Descrição

mixed current ( array array )

Todo array tem um ponteiro interno para o elemento "atual", o qual é inicializado para apontar para o primeiro elemento inserido em um array.

A função current() simplesmente retorna o elemento do array para o qual esse ponteiro interno está apontando. Não move o ponteiro de forma alguma. Se o ponteiro interno estiver apontando para além do final da lista de elementos, current() retorna `FALSE`.

Atenção
Se o array contêm elementos vazios (0 ou "", uma string vazia) então esta função retorna `FALSE` para esses elementos. Isso faz com que seja impossível determinar se você está realmente no final da lista de elementos de um array usando current(). Para percorrer devidamente um array que pode conter elementos vazios, use a função each().

Exemplo 1. Exemplo do uso de current() e amigos
`<?php $transport = array('foot', 'bike', 'car', 'plane'); $mode = current($transport); // $mode = 'foot'; $mode = next($transport); // $mode = 'bike'; $mode = current($transport); // $mode = 'bike'; $mode = prev($transport); // $mode = 'foot'; $mode = end($transport); // $mode = 'plane'; $mode = current($transport); // $mode = 'plane'; ?>`

Veja também end(), key(), next(), prev() e reset().

Anterior | Principal | Próxima
count | Acima | each