readdir

(PHP 4, PHP 5)

readdir — Lit une entrée du dossier

Description

string readdir ([ resource $dir_handle ] )

readdir() retourne le nom de la prochaine entrée du dossier identifié par dir_handle. Les entrées sont retournées dans l'ordre dans lequel elles sont enregistrées dans le système de fichiers.

Liste de paramètres

dir_handle: La ressource de dossier ouverte précédemment avec opendir(). Si la ressource de dossier n'est pas spécifiée, la dernière ressource ouverte avec la fonction opendir() sera utilisée.

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.

Exemples

Exemple #1 Liste de toutes les entrées d'un dossier

<?php

if ($handle = opendir('/chemin/vers/fichiers')) {
	echo "Gestionnaire du dossier : $handle\n";
	echo "Entrées :\n";

	/* Ceci est la façon correcte de traverser un dossier. */
	while (false !== ($entry = readdir($handle))) {
		echo "$entry\n";
	}

	/* Ceci est la MAUVAISE façon de traverser un dossier. */
	while ($entry = readdir($handle)) {
		echo "$entry\n";
	}

	closedir($handle);
}
?>

Exemple #2 Liste toutes les entrées du dossier courant et enlève les . et ..

<?php
if ($handle = opendir('.')) {
	while (false !== ($entry = readdir($handle))) {
		if ($entry != "." && $entry != "..") {
			echo "$entry\n";
		}
	}
	closedir($handle);
}
?>

Voir aussi

is_dir() - Indique si le fichier est un dossier
glob() - Recherche des chemins qui vérifient un masque
opendir() - Ouvre un dossier, et récupère un pointeur dessus
scandir() - Liste les fichiers et dossiers dans un dossier

opendir

Fonctions sur les dossiers

rewinddir

Manuel PHP