recv()是程式語言函式。
函式原型int recv( _In_ SOCKET s, _Out_ char *buf, _In_ int len, _In_ int flags);
基本介紹
- 中文名：recv()
- socket：s
- buf ：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()返回的大小如果等於請求的大小，那么很有可能是緩衝區還有數據未讀完，也意味著該次事件還沒有處理完，所以還需要再次讀取：
while(rs){ buflen = recv(activeevents[i].data.fd, buf, sizeof(buf), 0); if(buflen < 0) { // 由於是非阻塞的模式,所以當buflen為EAGAIN時,表示當前緩衝區已無數據可讀 // 在這裡就當作是該次事件已處理 if(buflen == EAGAIN) break; else return; } else if(buflen == 0) { // 這裡表示對端的socket已正常關閉. } if(buflen != sizeof(buf)) rs = 0; else rs = 1;// 需要再次讀取}注釋
本函式用於已連線的數據報或流式套接口進行數據的接收。
對SOCK_STREAM類型的套接口來說，本函式將返回所有可用的信息，最大可達緩衝區的大小。如果套接口被設定為線內接收帶外數據（選項為SO_OOBINLINE），且有帶外數據未讀入，則返回帶外數據。應用程式可通過調用ioctlsocket()的SOCATMARK命令來確定是否有帶外數據待讀入。
如果套接口為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()獲取相應錯誤信息。
