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()獲取相應錯誤信息。