возвращает указатель на структуру, содержащую следующий элемент каталога в потоке каталога
dirp
. Успешные вызовы
readdir
возвращают следующие элементы каталогов. При возникновении ошибки и в конце каталога
readdir
возвращает
NULL
. Системы, удовлетворяющие стандарту POSIX, возвращая
NULL
, не меняют переменную
errno
в случае достижения конца каталога и устанавливают ее значение, если обнаружена ошибка.
#include <sys/types.h>
#include <dirent.h>
struct dirent *readdir(DIR *dirp);
Просмотр каталога с помощью функции
readdir
не гарантирует формирование списка всех файлов (и подкаталогов) в каталоге, если в это время выполняются другие процессы, создающие и удаляющие файлы в каталоге.
В состав структуры
dirent
, содержащей реквизиты элемента каталога, входят следующие компоненты.
ino_t d_ino
— индекс файла;
char d_name[]
— имя файла.
Для выяснения других реквизитов файла в каталоге вам необходимо вызвать
stat
, который мы обсуждали ранее.
telldir
Функция
telldir
возвращает значение, регистрирующее текущую позицию в потоке каталога. Вы можете использовать ее в последующих вызовах функции
seekdir
для переустановки просмотра каталога, начиная с текущей позиции.
#include <sys/types.h>
#include <dirent.h>
long int telldir(DIR *dirp);
seekdir
Функция
seekdir
устанавливает указатель на элемент каталога в потоке каталога, заданном в параметре
dirp
. Значение параметра
loc
, применяемого для установки позиции, следует получить из предшествующего вызова функции
telldir
.
#include <sys/types.h>
#include <dirent.h>
void seekdir (DIR *dirp, long int loc);
closedir
Функция
closedir
закрывает поток каталога и освобождает ресурсы, выделенные ему. Она возвращает 0 в случае успеха и -1 при наличии ошибки.
#include <sys/types.h>
#include <dirent.h>
int closedir(DIR *dirp);
В приведенной далее программе printdir.c (упражнение 3.4) вы соберете вместе множество функций обработки файлов для создания простого перечня содержимого каталога. Каждый файл представлен отдельной строкой. У каждого подкаталога есть имя, за которым следует слэш, и файлы, содержащиеся в подкаталоге, выводятся с отступом шириной в четыре пробела.
Программа превращает каталог в подкаталоги, чтобы у найденных файлов были пригодные для использования имена, т.е. они могут передаваться непосредственно в функцию opendir. Программа будет давать сбои при просмотре структур с большим числом уровней вложенности, поскольку есть ограничение на разрешенное число открытых потоков каталогов.
Мы могли бы сделать программу более универсальной, принимая в качестве аргумента командной строки начальную точку просмотра.
Для того чтобы познакомиться с методами повышения универсальности программ, посмотрите исходный код таких утилит Linux, как
ls
и
find
.
Упражнение 3.4. Программа просмотра каталога
1. Начните с соответствующих заголовочных файлов и функции
printdir
, которая выводит содержимое текущего каталога. Она будет рекурсивно вызываться для вывода подкаталогов, применяя параметр
depth
для задания отступа.
#include <unistd.h>
#include <stdio.h>
#include <dirent.h>
#include <string.h>
#include <sys/stat.h>
#include <stdlib.h>
void printdir(char *dir, int depth) {
DIR *dp;
struct dirent *entry;
struct stat statbuf;
if ((dp = opendir(dir)) == NULL) {
fprintf(stderr, "cannot open directory: %s\n", dir);
return;
}
chdir(dir);
while((entry = readdir(dp)) != NULL) {
lstat(entry->d_name, &statbuf);
if (S_ISDIR(statbuf.st_mode)) {
/* Находит каталог, но игнорирует . и .. */
if (strcmp(".", entry->d_name) == 0 || strcmp("..", entry->d_name) == 0)