current
Retorna o elemento atual em um array
&reftitle.description;
mixedcurrent
arrayobjectarray
Todo array tem um ponteiro interno para o elemento "atual",
o qual é inicializado para apontar para o primeiro elemento inserido em
um array.
&reftitle.parameters;
array
O array.
&reftitle.returnvalues;
A função current simplesmente retorna
o valor do elemento do array que está sendo apontado pelo
ponteiro interno. Ela não move o ponteiro de forma alguma. Se o
ponteiro interno aponta para além do final da lista de elementos ou o array está
vazio, current retorna &false;.
&return.falseproblem;
&reftitle.changelog;
&Version;
&Description;
&standard.changelog.calling-on-objects;
&reftitle.examples;
Exemplo do uso de current e amigos
]]>
&reftitle.notes;
Os resultados de chamar current em um array vazio
e em um array, cujo ponteiro interno aponta para além do fim dos elementos,
são indistinguíveis de um elemento bool &false;.
Para percorrer adequadamente um array que pode conter elementos &false;, veja a
estrutura de controle &foreach;.
Para ainda usar current e checar adequadamente se o valor
é realmente um elemento do array, a key
do elemento current deve ser verificada como estritamente
diferente de &null;.
&reftitle.seealso;
end
key
each
prev
reset
next
&foreach;