READDIR(3)

NOME
readdir - lê um diretório

SINÓPSE
#include <sys/types.h>

#include <dirent.h>

struct dirent *readdir(DIR *dir);

DESCRIÇÃO
A função readdir() devolve um ponteiro para uma estrutura 'dirent' representado a próxima entrada no fluxo de diretórios apontado por dir. NULO é devolvido ao chegar no final de arquivo (EOF) ou se ocorrer um erro.

O dado devolvido por readdir() é sobrescrito por chamadas subseqüentes a readdir() para o mesmo fluxo de diretórios.

De acordo com a POSIX, a estrutura dirent contém um campo char d_name[] de tamanho não especificado, com no máximo NOME_MAX caracteres precedendo o caracter terminador nulo. O uso de outros campos irá prejudicar a portabilidade para seus programas.

VALORES RETORNADOS
A função readdir() devolve um ponteiro para uma estrutura 'dirent', ou NULO se ocorrer um erro ou chegar no final de arquivo.

ERROS

EBADF
    Descritor dir de fluxo de diretórios inválido.

DE ACORDO COM
SVID 3, POSIX, BSD 4.3.

VEJA TAMBÉM
read(2), opendir(3), closedir(3), rewinddir(3), seekdir(3), telldir(3), scandir(3).

TRADUZIDO POR LDP-BR em 13/06/2001.

  Tradução:
Marcelo Pereira da Silva <marcelo@pereira.com>

  Revisão.:
André Luiz Fassone <lonely_wolf@ig.com.br>