readdir

(PHP 4, PHP 5, PHP 7, PHP 8)

readdirLit une entrée du dossier

Description

readdir(?resource $dir_handle = null): string|false

Renvoie le nom de la prochaine entrée dans le dossier. Les entrées sont renvoyées dans l'ordre dans lequel elles sont stockées dans le système de fichiers.

Liste de paramètres

dir_handle
Un gestionnaire de dossier resource précédemment ouvert avec opendir(). Si dir_handle est null le dernier gestionnaire ouvert avec opendir() sera utilisé.

Valeurs de retour

Retourne le nom de l'entrée en cas de réussite, ou false si une erreur survient.

Avertissement

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
8.5.0 Utiliser null pour dir_handle est maintenant dépréciée. Au lieu de cela, le dernier gestionnaire de dossier ouvert doit être fourni explicitement.
8.0.0 dir_handle est désormais nullable.

Exemples

Pour une exemple complet, référez-vous à la documentation de la fonction opendir().

Voir aussi

  • opendir() - Ouvre un dossier, et récupère un pointeur dessus
  • rewinddir() - Retourne à la première entrée du dossier
  • closedir() - Ferme le pointeur sur le dossier
  • dir() - Retourne une instance de la classe Directory
  • is_dir() - Indique si le fichier est un dossier
  • glob() - Recherche des chemins qui vérifient un masque
  • scandir() - Liste les fichiers et dossiers dans un dossier
↑↓ • • •