C函数篇(recv函数)

简述

从一个 套接口接收数据。

表头文件：

#include<sys/types.h>

#include<sys/socket.h>

int PASCAL FAR recv( SOCKET s, char FAR* buf, int len, int flags);

s：一个标识已链接 套接口的描述字。

buf：用于接收数据的 缓冲区。

len： 缓冲区长度。

flags：指定调用方式。

流程

这里只描述同步Socket的recv函数的执行流程。当 应用程序调用recv函数时：

（1）recv先等待s的发送缓冲中的数据被协议传送完毕，若是协议在传送s的发送缓冲中的数据时出现网络错误，那么recv函数返回SOCKET_ERROR；

（2）若是s的发送缓冲中没有数据或者数据被协议成功发送完毕后，recv先检查套接字s的接收 缓冲区， 若是s接收缓冲区中没有数据或者协议正在接收数据，那么recv就一直等待，直到协议把数据接收完毕。当协议把数据接收完毕，recv函数就把s的接收缓 冲中的数据copy到buf中（注意协议接收到的数据可能大于buf的长度，因此在这种状况下要调用几回recv函数才能把s的接收缓冲中的数据copy 完。recv函数仅仅是copy数据，真正的接收数据是协议来完成的）；

recv函数返回其实际copy的字节数。若是recv在copy时出错，那么它返回SOCKET_ERROR；若是recv函数在等待协议接收数据时网络中断了，那么它返回0。

注意：在Unix系统下，若是recv函数在等待协议接收数据时网络断开了，那么调用recv的进程会接收到一个SIGPIPE信号，进程对该信号的默认处理是进程终止。

实例

读数据的时候须要考虑的是当recv()返回的大小若是等于请求的大小，那么颇有多是 缓冲区还有数据未读完，也意味着该次事件尚未处理完，因此还须要再次读取：

 1 while(rs)
 2 {
 3 buflen = recv(activeevents[i].data.fd, buf, sizeof(buf), 0);
 4 if(buflen < 0)
 5 {
 6 // 因为是非阻塞的模式,因此当errno为EAGAIN时,表示当前缓冲区已无数据可读
 7 // 在这里就看成是该次事件已处理
 8 if(errno == EAGAIN)
 9 break;
10 else
11 return;
12 }
13 else if(buflen == 0)
14 {
15 // 这里表示对端的socket已正常关闭.
16 }
17 if(buflen != sizeof(buf))
18 rs = 0;
19 else
20 rs = 1;// 须要再次读取
21 }

注释

本函数用于已链接的数据报或流式 套接口进行数据的接收。

对SOCK_STREAM类型的 套接口来讲，本函数将返回全部可用的信息，最大可达 缓冲区的大小。若是 套接口被设置为线内接收 带外数据（选项为SO_OOBINLINE），且有带外数据未读入，则返回带外数据。 应用程序可经过调用 ioctlsocket()的SOCATMARK命令来肯定是否有 带外数据待读入。

对于数据报类 套接口，队列中第一个数据报中的数据被 解包，但最多不超过 缓冲区的大小。若是数据报大于 缓冲区，那么缓冲区中只有数据报的前面部分，其余的数据都丢失了，而且recv()函数返回WSAEMSGSIZE错误。若是没有数据待读，那么除非是非阻塞模式，否则的话 套接口将一直等待数据的到来，此时将返回SOCKET_ERROR错误， 错误代码是WSAEWOULDBLOCK。用 select()或WSAAsynSelect()能够获知什么时候数据到达。

若是 套接口为SOCK_STREAM类型，而且远端“优雅”地停止了链接，那么recv()一个数据也不读取，当即返回。若是当即被强制停止，那么recv()将以WSAECONNRESET错误失败返回。在 套接口的所设选项之上，还可用标志位flag来影响函数的执行方式。也就是说，本函数的语义既取决于 套接口选项，也取决于标志位参数。标志位可取下列值：

值意义

windows版本:

第四个参数：

MSG_PEEK 查看当前数据。数据将被复制到 缓冲区中，但并不从输入队列中删除。

MSG_OOB 处理 带外数据（参见2.2.3节具体讨论）。

返回值：

若无错误发生，recv()返回读入的字节数。若是链接已停止，返回0。不然的话，返回SOCKET_ERROR错误， 应用程序可经过WSAGetLastError()获取相应 错误代码。

错误代码：

WSANOTINITIALISED：在使用此API以前应首先成功地调用WSAStartup()。

WSAENETDOWN：WINDOWS 套接口实现检测到网络子系统失效。

WSAENOTCONN： 套接口未链接。

WSAEINTR：阻塞进程被WSACancelBlockingCall()取消。

WSAEINPROGRESS：一个阻塞的WINDOWS 套接口调用正在运行中。

WSAENOTSOCK：描述字不是一个 套接口。

WSAEOPNOTSUPP：指定了MSG_OOB，但 套接口不是SOCK_STREAM类型的。

WSAESHUTDOWN： 套接口已被关闭。当一个 套接口以0或2的how参数调用shutdown()关闭后，没法再用recv()接收数据。

WSAEWOULDBLOCK： 套接口标识为非阻塞模式，但接收操做会产生阻塞。

WSAEMSGSIZE：数据报太大没法所有装入 缓冲区，故被剪切。

WSAEINVAL： 套接口未用bind()进行捆绑。

WSAECONNABORTED：因为超时或其余缘由，虚电路失效。

WSAECONNRESET：远端强制停止了虚电路。

linux版本:

第四个参数：

MSG_DONTROUTE 绕过路由表查找。

MSG_DONTWAIT 仅本操做非阻塞。

MSG_OOB 发送或接收带外数据。

MSG_PEEK 窥看外来消息。

MSG_WAITALL 等待全部数据。

返回值：

若无错误发生，recv()返回读入的字节数。若是链接已停止，返回0。若是发生错误，返回-1， 应用程序可经过perror()获取相应错误信息。