C语言函数stat()详解：文件属性获取与错误处理28

在C语言编程中，`stat()` 函数扮演着至关重要的角色，它允许程序获取文件系统中文件或目录的各种属性信息。理解和熟练运用 `stat()` 函数对于构建健壮的文件操作程序至关重要。本文将详细介绍 `stat()` 函数的用法、参数、返回值以及错误处理机制，并辅以代码示例，帮助读者更好地掌握这个强大的函数。

函数原型

stat() 函数的原型定义在 `` 头文件中：#include <sys/stat.h>
int stat(const char *path, struct stat *buf);

其中：
path：指向一个以空字符结尾的字符串的指针，表示要获取属性的文件或目录的路径。
buf：指向一个 struct stat 结构体的指针。该结构体将存储文件或目录的属性信息。struct stat 的内容在不同的操作系统上可能略有不同，但通常包含以下成员：

`struct stat` 的主要成员：
st_dev：设备 ID。
st_ino：inode 号码 (文件系统中的唯一标识符)。
st_mode：文件模式，包含文件类型（例如，常规文件、目录、符号链接等）和权限信息 (读、写、执行)。
st_nlink：硬链接数。
st_uid：文件所有者的用户 ID。
st_gid：文件所有者的组 ID。
st_rdev：设备 ID (对于设备文件)。
st_size：文件大小（以字节为单位）。
st_atime：最后访问时间。
st_mtime：最后修改时间。
st_ctime：最后状态改变时间。

返回值

stat() 函数成功执行时返回 0，否则返回 -1 并设置全局变量 errno 来指示错误。常见的错误包括：
ENOENT：文件或目录不存在。
EACCES：没有权限访问文件或目录。
ELOOP：符号链接循环。
ENAMETOOLONG：路径名太长。

示例代码：#include <stdio.h>
#include <stdlib.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <unistd.h>
#include <errno.h>
#include <string.h>
#include <time.h>
int main() {
struct stat fileStat;
char filePath[256];
printf("请输入文件路径: ");
fgets(filePath, sizeof(filePath), stdin);
//去除fgets()读取的换行符
filePath[strcspn(filePath, "")] = 0;

if (stat(filePath, &fileStat) == 0) {
printf("文件大小: %lld 字节", fileStat.st_size);
printf("最后修改时间: %s", ctime(&fileStat.st_mtime)); //ctime()自动添加换行符
//使用mode宏判断文件类型和权限
if (S_ISREG(fileStat.st_mode)) {
printf("文件类型: 普通文件");
} else if (S_ISDIR(fileStat.st_mode)) {
printf("文件类型: 目录");
} else if (S_ISLNK(fileStat.st_mode)) {
printf("文件类型: 符号链接");
} else {
printf("文件类型: 其他");
}
//权限信息
printf("权限: ");
if(fileStat.st_mode & S_IRUSR) printf("r"); else printf("-");
if(fileStat.st_mode & S_IWUSR) printf("w"); else printf("-");
if(fileStat.st_mode & S_IXUSR) printf("x"); else printf("-");
if(fileStat.st_mode & S_IRGRP) printf("r"); else printf("-");
if(fileStat.st_mode & S_IWGRP) printf("w"); else printf("-");
if(fileStat.st_mode & S_IXGRP) printf("x"); else printf("-");
if(fileStat.st_mode & S_IROTH) printf("r"); else printf("-");
if(fileStat.st_mode & S_IWOTH) printf("w"); else printf("-");
if(fileStat.st_mode & S_IXOTH) printf("x"); else printf("-");
printf("");

} else {
perror("stat() 错误"); //使用perror()打印更友好的错误信息
return 1;
}
return 0;
}