readdir(3) - 디렉토리 소속의 파일정보를 읽음

readdir(3)

#include <dirent.h>

struct dirent *readdir(DIR *dirp);

디렉토리의 하위에 있는 파일 및 디렉토리 정보를 한 건 읽습니다. readdir(3)에 대해서 1회 호출에 1건의 정보를 return 합니다. 읽는 순서는 시간 순서, 파일명 순서, 파일 크기 등 어떤 기준이 없으므로 기본적으로 sorting이 되어 있지 않습니다.

 

 

파라미터

dirp
    - opendir(3) 또는 fdopendir(3)을 통하여 생성된 DIR *

 

RETURN

NULL이 아닌 경우
    - 파일 또는 directory 정보를 얻습니다.
    - LINUX의 struct dirent 구조체는 아래와 같으나, 
    - UNIX 마다 다르므로 호환성을 유지하기 위해서는 d_name만 유효합니다.

     struct dirent {
        ino_t          d_ino;       /* inode number */
        off_t          d_off;       /* offset to the next dirent */
        unsigned short d_reclen;    /* length of this record */
        unsigned char  d_type;      /* type of file; not supported by all file system types */
        char           d_name[256]; /* filename */
     };


NULL
    - 더 이상 읽을 정보가 없거나 오류가 발생하였으며, 상세한 오류는 errno에 저장됩니다.
    - EBADF : dirp가 유효하지 않습니다.

 

---

활용 예제

 

Sample. 로그인한 home directory의 전체 파일 목록 출력

#include <stdio.h>
#include <string.h>
#include <stdlib.h>
#include <sys/types.h>
#include <dirent.h> 


int main(int argc, char **argv)
{
    DIR           *dir_ptr = NULL;
    struct dirent *file    = NULL;
    char           home[1024];

    strncpy(home, getenv("HOME"), sizeof(home));

    /* 목록을 읽을 디렉토리명으로 DIR *를 return 받습니다. */
    if((dir_ptr = opendir(home)) == NULL) 
    {
        fprintf(stderr, "%s directory 정보를 읽을 수 없습니다.\n", home);
        return -1;
    }

    /* 디렉토리의 처음부터 파일 또는 디렉토리명을 순서대로 한개씩 읽습니다. */
    while((file = readdir(dir_ptr)) != NULL) 
    {
        /*
        *   struct dirent *의 구조체에서 d_name 이외에는 
        *   시스템마다 항목이 없을 수 있으므로 무시하고 이름만 사용합니다.
        */

        printf("%s\n", file->d_name);
    }

    /* open된 directory 정보를 close 합니다. */

    closedir(dir_ptr);
    
    return 0;
}

 

---

see also :

    File 속성 정보 및 파일 관리 Library

    Directory 정보 조회 및 관리 Library

    System Call File I/O Library

    Stream File I/O Library