struct-iovec

发表于

struct iovec 结构体定义与使用

1 .struct iovec定义了一个向量元素。通常，这个结构用作一个多元素的数组。对于每一个传输的元素，指针成员iov_base指向一个缓冲区，这个缓冲区是存放的是readv所接收的数据或是writev将要发送的数据。成员iov_len在各种情况下分别确定了接收的最大长度以及实际写入的长度。

2 .在这里，主要介绍readv和writev两个函数；readv(2)与writev(2)函数都使用一个I/O向量的概念；在头文件中定义了struct iovec 结构体，其定义和各成员如下：

1
2
3
4
5
6
7
struct iovec {
	 /* Starting address (内存起始地址）*/
   void  *iov_base;   

    /* Number of bytes to transfer（这块内存长度） */
   size_t iov_len;    
       };

linux中使用这样的结构体变量作为参数的函数很多，常见的有：

1
2
3
4
5
6
7
8
9
10
11
头文件：
 #include <sys/uio.h>

 ssize_t readv(int fd, const struct iovec *iov, int iovcnt);

 ssize_t writev(int fd, const struct iovec *iov, int iovcnt);

 ssize_t preadv(int fd, const struct iovec *iov, int iovcnt, off_t offset);
 ssize_t pwritev(int fd, const struct iovec *iov, int iovcnt,off_t offset);     
 ssize_t preadv2(int fd, const struct iovec *iov, int iovcnt, off_t offset, int flags);
 ssize_t pwritev2(int fd, const struct iovec *iov, int iovcnt, off_t offset, int flags);

readv和writev作为read与write函数的衍生函数，在一个原子操作中读取或是写入多个缓冲区。readv和writev函数中的各参数的含义如下：
函数原型：

1
2
3
ssize_t readv(int fd, const struct iovec *iov, int iovcnt);

ssize_t writev(int fd, const struct iovec *iov, int iovcnt);

这两个函数需要三个参数：
要在其上进行读或是写的文件描述符fd
读或写所用的I/O向量(vector)
要使用的向量元素个数(count)
这些函数的返回值是readv所读取的字节数或是writev所写入的字节数。如果有错误发生，就会返回-1，而errno存有错误代码。注意，也其他I/O函数类似，可以返回错误码EINTR来表明他被一个信号所中断。

3 .示例代码1
代码的功能是：向终端（屏幕）打印字符串：i am happy.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
/*************************************************************************
 * File Name: struct_iovec.c
 * Author:    The answer
 * Function:  Other        
 * Mail:      2412799512@qq.com 
 * Created Time: 2017年06月17日 星期六 20时36分21秒
*************************************************************************/

#include<stdio.h>
#include<sys/uio.h>
#include<unistd.h>
#include<fcntl.h>
#include<sys/types.h>
#include<sys/stat.h>
#include<stdlib.h>
#include<string.h>

void sys_err(const char *ptr,int num)
{
    perror(ptr);
    exit(-1);
}

int main(int argc,char **argv)
{
    struct iovec iov[3];
    char *p1 = "i";
    char *p2 = " am";
    char *p3 = " happy.\n";
    iov[0].iov_base = p1;
    iov[0].iov_len = strlen(p1);

    iov[1].iov_base = p2;
    iov[1].iov_len = strlen(p2);
    
    iov[2].iov_base = p3;
    iov[2].iov_len = strlen(p3);
    ssize_t ret = writev(STDOUT_FILENO,iov,3);
    if(ret < 0)
    {
        sys_err("writev",-1);
    }
    return 0;
}

原文：https://blog.csdn.net/lixiaogang_theanswer/article/details/73385643