eio_readdir
Lit le contenu d'un dossier
&reftitle.description;
resourceeio_readdir
stringpath
intflags
intpri
callablecallback
stringdataNULL
Lit le contenu complet d'un dossier (via les appels systèmes
opendir, readdir et
closedir) et retourne soit les noms, soit un tableau
suivant la valeur de l'argument flags.
&reftitle.parameters;
path
Chemin du dossier.
flags
Combinaison de constantes EIO_READDIR_*.
pri
&eio.request.pri.values;
callback
&eio.callback.proto;
data
Variables arbitraires à passer à la fonction de rappel
callback.
&reftitle.returnvalues;
eio_readdir retourne la ressource demandée en cas
de succès,&return.falseforfailure;.
Définissez l'argument
result de la fonction de rappel
callback suivant le drapeau
flags utilisé :
EIO_READDIR_DENTS
(&integer;)
Drapeau pour eio_readdir.
Si spécifié, l'argument de résultat de la fonction de rappel
devient un tableau contenant les clés suivantes :
'names' - tableau de noms de dossiers
'dents' - tableau de struct
eio_dirent - comme un tableau, mais contenant les clés spécifiques suivantes :
'name' - le nom du dossier ;
'type' - une des constantes EIO_DT_* ;
'inode' - le numbre d'inodes, si disponible, sinon ne sera pas spécifié ;
EIO_READDIR_DIRS_FIRST
(&integer;)
Lorsque ce drapeau est spécifié, les noms seront retournés dans un ordre
où les dossiers arrivent en premier, et ensuite dans un ordre de statut optimal.
EIO_READDIR_STAT_ORDER
(&integer;)
Lorsque ce drapeau est spécifié, alors les noms seront retournés dans un
ordre suivant le statut stat de chaque nœud.
Si vous avez prévu d'appliquer la fonction stat a tous
les fichiers du dossier, il vous sera plus rapide d'utiliser ce drapeau.
EIO_READDIR_FOUND_UNKNOWN
(&integer;)
Types de nœud :
EIO_DT_UNKNOWN
(&integer;)
Un nœud de type inconnu (souvent le cas). Une utilisation de la fonction
stat est nécessaire.
EIO_DT_FIFO
(&integer;)
Un nœud de type FIFO
EIO_DT_CHR
(&integer;)
Type de nœud
EIO_DT_MPC
(&integer;)
Un nœud de type périphérique à caractères multiplexés (v7+coherent)
EIO_DT_DIR
(&integer;)
Un nœud de type dossier
EIO_DT_NAM
(&integer;)
Un nœud de type fichier nommé spécialement Xenix
EIO_DT_BLK
(&integer;)
Type de nœud
EIO_DT_MPB
(&integer;)
Bloc multiplexé du périphérique (v7+coherent)
EIO_DT_REG
(&integer;)
Type de nœud
EIO_DT_NWK
(&integer;)
EIO_DT_CMP
(&integer;)
Un nœud de type spécial du réseau HP-UX
EIO_DT_LNK
(&integer;)
Un nœud de type lien
EIO_DT_SOCK
(&integer;)
Un nœud de type socket
EIO_DT_DOOR
(&integer;)
Un nœud de type Solaris door
EIO_DT_WHT
(&integer;)
Type de nœud
EIO_DT_MAX
(&integer;)
Valeur de type de nœud le plus haut possible
&reftitle.examples;
Exemple avec eio_readdir
]]>
&example.outputs.similar;
array(7) {
[0]=>
string(7) "archive"
[1]=>
string(8) "articles"
[2]=>
string(8) "incoming"
[3]=>
string(7) "innfeed"
[4]=>
string(8) "outgoing"
[5]=>
string(8) "overview"
[6]=>
string(3) "tmp"
}
["dents"]=>
array(7) {
[0]=>
array(3)
{
["name"]=>
string(7)
"archive"
["type"]=>
int(4)
["inode"]=>
int(393265)
}
[1]=>
array(3)
{
["name"]=>
string(8)
"articles"
["type"]=>
int(4)
["inode"]=>
int(393266)
}
[2]=>
array(3)
{
["name"]=>
string(8)
"incoming"
["type"]=>
int(4)
["inode"]=>
int(393267)
}
[3]=>
array(3)
{
["name"]=>
string(7)
"innfeed"
["type"]=>
int(4)
["inode"]=>
int(393269)
}
[4]=>
array(3)
{
["name"]=>
string(8)
"outgoing"
["type"]=>
int(4)
["inode"]=>
int(393270)
}
[5]=>
array(3)
{
["name"]=>
string(8)
"overview"
["type"]=>
int(4)
["inode"]=>
int(393271)
}
[6]=>
array(3)
{
["name"]=>
string(3)
"tmp"
["type"]=>
int(4)
["inode"]=>
int(393272)
}
}
}
]]>