Manuel PHP
Précédent |  | Suivant

# dir

dir -- Classe de dossier DIR

## Description

class dir {
dir ( string directory )
string path
resource handle
string read ( void )
void rewind ( void )
void close ( void )
}

Un mécanisme pseudo-objet permet la lecture d'un dossier. L'argument directory est ouvert. Deux propriétés sont disponibles une fois le dossier ouvert : le pointeur peut être utilisé avec d'autres fonctions telles que readdir(), rewinddir() et closedir(). Le chemin du dossier est le chemin fourni lors de la construction de l'objet. Trois méthodes permettent de lire, remettre à zéro et fermer le dossier.

Notez la façon dont la valeur de retour de dir() est vérifiée dans l'exemple suivant. Nous testons si la valeur est identique (égale et de même type que -- woyez opérateurs de comparaison pour plus de détails) `FALSE` sinon, toute entrée dans le nom serait évalué à `FALSE` causera l'arrêt de la boucle (exemple, un répertoire nommé 0).

Exemple 1. Exemple avec dir()
`<?php $d = dir("/etc/php5"); echo "Pointeur : " . $d->handle . "\n"; echo "Chemin : " . $d->path . "\n"; while (false !== ($entry = $d->read())) { echo $entry . "\n"; } $d->close(); ?>`
L'exemple ci-dessus va afficher quelque chose de similaire à :
    Pointeur : Resource id #2
    Chemin : /etc/php5
    .
    ..
    apache
    cgi
    cli

> Note : L'ordre dans lequel les entrées du dossier sont retournées avec la méthode read dépend de votre système.

> Note : Ceci défini la classe interne Directory, ce qui signifie que vous ne pourrez pas nommer une nouvelle classe avec ce nom. Pour une liste complète des classes pré-définies en PHP, lisez classes pré-définies.

Précédent | Sommaire | Suivant
chroot | Niveau supérieur | closedir