C语言文件操作笔记-3

文件函数说明

此为基础篇文件操作，涉及基础使用函数：
stat、fstat、lstat函数说明。

相关函数说明：

stat

函数说明： stat。

/*************头文件*****************/
#include <sys/types.h>
#include <sys/stat.h>
#include <unistd.h>
/*****************************
 * 函数名称：stat
 * 函数入口：
 *             file_name:文件名
 *             buf: 文件信息结构体具体说明如下：
 * 
 * 函数出口：
 *        执行成功返回0，失败返回-1，错误代码存于errno
 * 函数说明：
 *        stat函数获取file_name指向文件的文件状态，并将文件信息保存到结构体buf中
 * ***************************/
int stat(const char * file_name, struct stat * buf);

fstat

函数说明： fstat。

/*************头文件*****************/
#include <sys/types.h>
#include <sys/stat.h>
#include <unistd.h>
/*****************************
 * 函数名称：fstat
 * 函数入口：
 *             fd 文件句柄
 *             statbuf: 文件信息结构体具体说明如下：
 * 
 * 函数出口：
 *        执行成功返回0，失败返回-1，错误代码保存在errno中。
 * 函数说明：
 *        fstat函数获取file_name指向文件的文件状态，并将文件信息保存到结构体buf中
 * ***************************/
 int fstat(int fd, struct stat *statbuf);

lstat

函数说明： lstat。

/*************头文件*****************/
#include <sys/types.h>
#include <sys/stat.h>
#include <unistd.h>
/*****************************
 * 函数名称：lstat
 * 函数入口：
 *             pathname 文件名称
 *             statbuf: 文件信息结构体具体说明如下：
 * 
 * 函数出口：
 *        执行成功返回0，失败返回-1，错误代码保存在errno中。
 * 函数说明：
 *        lstat函数获取file_name指向文件的文件状态，并将文件信息保存到结构体buf中
 * ***************************/
int lstat(const char *pathname, struct stat *statbuf);

区别：
lstat函数的形参跟stat函数的形参一样。其功能也跟stat函数功能一样，仅有一点不同：stat函数是穿透（追踪）函数，即对软链接文件进行操作时，操作的是链接到的那一个文件，不是软链接文件本身；而lstat函数是不穿透（不追踪）函数，对软链接文件进行操作时，操作的是软链接文件本身。

stat包含结构体注释说明：

struct stat
{
    dev_t st_dev; //device 文件的设备编号
    ino_t st_ino; //inode 文件的索引节点
    mode_t st_mode; //protection 文件的类型和存取的权限
    nlink_t st_nlink; //number of hard links 连到该文件的硬连接数目, 刚建立的文件值为1.
    uid_t st_uid; //user ID of owner 文件所有者的用户识别码
    gid_t st_gid; //group ID of owner 文件所有者的组识别码
    dev_t st_rdev; //device type 若此文件为装置设备文件, 则为其设备编号
    off_t st_size; //total size, in bytes 文件大小, 以字节计算
    unsigned long st_blksize; //blocksize for filesystem I/O 文件系统的I/O 缓冲区大小.
    unsigned long st_blocks; //number of blocks allocated 占用文件区块的个数, 每一区块大小为512 个字节.
    time_t st_atime; //time of lastaccess 文件最近一次被存取或被执行的时间, 一般只有在用mknod、utime、read、write 与tructate 时改变.
    time_t st_mtime; //time of last modification 文件最后一次被修改的时间, 一般只有在用mknod、utime 和write 时才会改变
    time_t st_ctime; //time of last change i-node 最近一次被更改的时间, 此参数会在文件所有者、组、权限被更改时更新
};

st_mode说明：

1、S_IFMT 0170000 文件类型的位遮罩
2、S_IFSOCK 0140000 scoket
3、S_IFLNK 0120000 符号连接
4、S_IFREG 0100000 一般文件
5、S_IFBLK 0060000 区块装置
6、S_IFDIR 0040000 目录
7、S_IFCHR 0020000 字符装置
8、S_IFIFO 0010000 先进先出
9、S_ISUID 04000 文件的 (set user-id on execution)位
10、S_ISGID 02000 文件的 (set group-id on execution)位
11、S_ISVTX 01000 文件的sticky 位
12、S_IRUSR (S_IREAD) 00400 文件所有者具可读取权限
13、S_IWUSR (S_IWRITE)00200 文件所有者具可写入权限
14、S_IXUSR (S_IEXEC) 00100 文件所有者具可执行权限
15、S_IRGRP 00040 用户组具可读取权限
16、S_IWGRP 00020 用户组具可写入权限
17、S_IXGRP 00010 用户组具可执行权限
18、S_IROTH 00004 其他用户具可读取权限
19、S_IWOTH 00002 其他用户具可写入权限
20、S_IXOTH 00001 其他用户具可执行权限上述的文件类型在 POSIX 中定义了检查这些类型的宏定义
21、S_ISLNK (st_mode) 判断是否为符号连接
22、S_ISREG (st_mode) 是否为一般文件
23、S_ISDIR (st_mode) 是否为目录
24、S_ISCHR (st_mode) 是否为字符装置文件
25、S_ISBLK (s3e) 是否为先进先出
26、S_ISSOCK (st_mode) 是否为socket 若一目录具有sticky 位 (S_ISVTX), 则表示在此目录下的文件只能被该文件所有者、此目录所有者或root 来删除或改名.

错误代码：

 1、ENOENT 参数file_name 指定的文件不存在 
 2、ENOTDIR 路径中的目录存在但却非真正的目录
 3、ELOOP 欲打开的文件有过多符号连接问题, 上限为16 符号连接
 4、EFAULT 参数buf 为无效指针, 指向无法存在的内存空间
 5、EACCESS 存取文件时被拒绝
 6、ENOMEM 核心内存不足
 7、ENAMETOOLONG 参数file_name 的路径名称太长  

st_mode 主要包含了 3 部分信息：

st_mode 主要包含了 3 部分信息：
15-12 位保存文件类型
11-9 位保存执行文件时设置的信息
8-0 位保存文件访问权限

示例代码：

示例1：stat基本使用

#include "stdio.h"
#include "string.h"
#include <sys/stat.h>
#include <time.h>
void main()
{
  struct stat fstat_str;
  struct tm *time_str;
  char buf[]="$GPGGA,092204.999,4250.5589,S,14718.5084,E,2,04,24.4,19.7,M,,,,0000*1F$GPGGA,092204.999,4250.5589,S,14718.5084,E,2,04,24.4,19.7,M,,,, NULL";
  FILE *fp=fopen("./test.txt","w+");
  fwrite(buf,strlen(buf)+1,1,fp);
  printf("%ld\r\n",ftell(fp));
  fclose(fp);
  stat("./test.txt", &fstat_str);
  printf("creat time:%s\r\n",ctime( &fstat_str.st_ctime));//创建时间
  printf("lastaccess time:%s\r\n",ctime( &fstat_str.st_atime));//最近存取时间只有read write truncate等操作下改变
  printf("last modificat time:%s\r\n",ctime( &fstat_str.st_mtime));//最有一次修改时间 write等
  time_str= localtime(&fstat_str.st_ctime);
  printf("%d-%d-%d :%d:%d:%d\r\n",time_str->tm_year+1900,time_str->tm_mon,time_str->tm_mday,time_str->tm_hour,time_str->tm_min,time_str->tm_sec);
  printf("size:%ld\r\n",fstat_str.st_size);
}

运行结果：
139
creat time:Tue Jan 10 22:49:55 2023

lastaccess time:Tue Jan 10 21:34:24 2023

last modificat time:Tue Jan 10 22:49:55 2023

2023-0-10 :22:49:55
size:139

感谢阅读，欢迎批阅，后期会持续维护…