注释
本函数用于已连接的数据报或流式
套接口进行数据的接收。
对于数据报类
套接口,队列中第一个数据报中的数据被
解包,但最多不超过
缓冲区的大小。如果数据报大于
缓冲区,那么缓冲区中只有数据报的前面部分,其他的数据都丢失了,并且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
套接口实现检测到网络子系统失效。
WSAEINTR:阻塞进程被WSACancelBlockingCall()取消。
WSAEINPROGRESS:一个阻塞的WINDOWS
套接口调用正在运行中。
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()获取相应错误信息。