current
(PHP 4, PHP 5, PHP 7)
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.
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.
Historique
| Version | Description |
|---|---|
| 7.0.0 |
array est maintenant toujours passé par valeur.
Précédemment à cette version,il était passé par
référence si possible et par valeur dans les autres cas.
|
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: Il n'est pas possible de distinguer la fin d'un tableau ou le résultat de l'appel current() sur un tableau vide, à partir de l'élément boolean
FALSE. Pour traverser correctement un tableau qui peut contenir l'élémentFALSE, voyez la fonction foreach(). Pour continuer d'utiliser current() et vérifier correctement si la valeur est réellement un élément du tableau, la key() de l'élément current() devrait être comparée strictement différente de l'élémentNULL.
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
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.current.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.
