stat(), stat64()

Получить информацию о файле или директории по заданному пути

Прототип:

#include <sys/stat.h>
int stat( const char *path,
struct stat *buf );
int stat64( const char *path,
struct stat64 *buf );

Аргументы:

path
Путь к файлу или каталогу, о котором необходимо получить информацию.
buf
Указатель на буфер типа struct stat, где функция может хранить информацию.

Библиотека:

libc

Описание:

Функции stat() и stat64() получают информацию о файле или каталоге, указанном в параметре path. Эта информация размещается в структуре struct stat, расположенной по адресу, указанному в параметре buf.

Возвращаемое значение:

0
Успешное завершение.
-1
Возникла ошибка. Код ошибки записан в errno.

Коды ошибок:

EACCES
Отсутствуют права на поиск для компонента пути path.
EIO
На блочном устройстве произошла физическая ошибка.
ELOOP
Слишком много уровней символических ссылок или префиксов.
ENAMETOOLONG
Длина аргумента path превышает PATH_MAX или компонент имени пути длиннее NAME_MAX. PATH_MAX и NAME_MAX определены в заголовочном файле <limits.h> .
ENOENT
Указанный файл не существует, или path является пустой строкой.
ENOSYS
Функция stat() не реализована для файловой системы, указанной в path.
ENOTDIR
Компонент пути path не является каталогом.
EOVERFLOW
Размер файла в байтах или количество блоков, выделенных для файла, или серийный номер файла не могут быть правильно представлены в структуре, на которую указывает buf.

Примеры:

Определение размера файла:

#include <stdio.h>
#include <stdlib.h>
#include <sys/stat.h>
int main( void )
{
struct stat buf;
if ( stat( "file", &buf ) != -1 )
{
printf( "File size = %d\n", buf.st_size );
}
return (EXIT_SUCCESS);
}

Определение объема свободной памяти:

#include <stdio.h>
#include <stdlib.h>
#include <sys/stat.h>
int main( void )
{
struct stat buf;
if ( stat( "/proc", &buf ) == -1 )
{
perror( "stat" );
return (EXIT_FAILURE);
} else {
printf( "Free memory: %d bytes\n", buf.st_size );
return (EXIT_SUCCESS);
}
}

Классификация:

stat() — POSIX 1003.1; stat64() — Поддержка больших файлов

Точка остановки потока
Нет
Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

Тематические ссылки:

struct stat, time_t, errno, fstat(), fstat64(), lstat()




Предыдущий раздел: Описание API системной библиотеки