fopencookie函数详解

今天看DPDK时,看到了fopencookie函数,以前基本没有用过该函数,乘此机会好好看看如何使用。

1. 函数头文件与函数原型 

函数头文件: #include <stdio.h>

函数原型:

FILE *fopencookie(void *cookie, const char *mode, cookie_io_functions_t io_funcs);

2. 函数及参数说明

该函数用来DIY一个流,什么是流,比如标准输入,标准输出。

参数:

(1 cookie

cookie是一种自定义的数据结构,用于和后面的io_funcs配合使用,可以为NULL。

(2 mode

打开方式,和fopen相同,包括:r,w,a,r+,w+,a+。

(3 io_funcs

四个函数指针组成的函数集,需要用户实现这四个函数指针。我们仔细看看:

io_funcs:

typedef struct {
cookie_read_function_t *read;
cookie_write_function_t *write;
cookie_seek_function_t *seek;
cookie_close_function_t *close;
} cookie_io_functions_t;

第一个read函数实现从流的读操作,原型如下:
ssize_t read(void *cookie, char *buf, size_t size);
该函数必须返回读到数据的字节数,注意是读到,意味着流数据要拷贝到
buf中。返回0表示EOF,-1表示出错。该函数必须要更新流的offset。

第二个函数write实现向流的写操作,原型如下:
ssize_t write(void *cookie, const char *buf, size_t size);
基本和上面read类似。

第三个函数seek实现挪动流的offset,原型如下:
int seek(void *cookie, off64_t *offset, int whence);
offset更具whence的取值指明了流指针要移动到的位置。基本和系统调用的seek函数类似。
返回0表示成功,返回-1表示失败。

第四个函数close用于关闭流,该函数用来释放流所用到的缓冲区资源。

原文地址:https://www.cnblogs.com/kb342/p/5772896.html