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用于关闭流，该函数用来释放流所用到的缓冲区资源。