READDIR(3)

이름
readdir - 디렉토리를 읽다

사용법
#include <sys/types.h>

#include <dirent.h>

struct dirent *readdir(DIR *dir);

설명
readdir() 함수는 dir이 가리키는 디렉토리 기술자의 다음 디렉토리 항목을 나타내는 dirent 구조체를 반환한다. 파일 끝에 도달하거나 에러가 발생하면 NULL을 반환한다.

readdir()에 의해 반환되는 데이터는 같은 디렉토리 스트림에 대한 다음의 readdir() 호출에 의해 덮어 쓰여진다.

POSIX에 따르면, dirent 구조체는 지정되지 않은 크기의 char d_name[] 필드를 포함한다. 최대 길이는 종료 NULL 문자를 제외하고 NAME_MAX이다. 다른 필드를 사용하는 것은 프로그램의 이식성을 떨어트릴 것이다.

반환값
readdir() 함수는 dirent 구조체의 포인터를, 또는 에러가 발생하거나 파일 끝에 도달하면 NULL을 반환한다.

에러

EBADF
    무효한 디렉토리 스트림 기술자 dir

호환
SVID 3, POSIX, BSD 4.3

관련 항목
read(2), opendir(3), closedir(3), rewinddir(3), seekdir(3), telldir(3), scandir(3)

역자
임종균 <hermes44@secsm.org>, 2001년 6월 28일