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