current
(PHP 4, PHP 5)
current — Retourne l'élément courant du tableau
Description
Chaque tableau entretient un pointeur interne, qui est initialisé lorsque le premier élément est inséré dans le tableau.
Liste de paramètres
-
array -
Le tableau.
Valeurs de retour
current() ne fait que retourner
l'élément courant pointé par le pointeur interne du
tableau array.
current() ne déplace pas le pointeur.
Si le pointeur est au-delà du dernier élément de la liste,
current() retourne FALSE.
Cette fonction peut
retourner FALSE, mais elle peut aussi retourner une valeur équivalent à
FALSE. Veuillez lire la section sur
les booléens pour plus d'informations.
Utilisez l'opérateur ===
pour tester la valeur de retour exacte de cette fonction.
Exemples
Exemple #1 Exemple d'utilisation de current()
<?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';
$arr = array();
var_dump(current($arr)); // bool(false)
$arr = array(array());
var_dump(current($arr)); // array(0) { }
?>Notes
Note: Vous ne serez pas capable de distinguer la fin d'un tableau avec l'élément booléen
FALSE. Pour traverser correctement un tableau qui peut contenir l'élémentFALSE, voyez la fonction each().
Voir aussi
- end() - Positionne le pointeur de tableau en fin de tableau
- key() - Retourne une clé d'un tableau associatif
- each() - Retourne chaque paire clé/valeur d'un tableau
- prev() - Recule le pointeur courant de tableau
- reset() - Remet le pointeur interne de tableau au début
- next() - Avance le pointeur interne d'un tableau
