複製鏈接
請複製以下鏈接發送給好友
https://baike.baidu.hk/item/recv()/10082153
複製
複製成功

recv()

鎖定
recv()是編程語言函數。
函數原型int recv( _In_ SOCKET s, _Out_ char *buf, _In_ int len, _In_ int flags);
中文名
recv()
socket
s
buf
buf
len
緩衝區長度。
flags
指定調用方式。

目錄

  1. 1 介紹
  2. 2 流程
  3. 3 實例
  4. 4 註釋
  5. ▪ 值意義
  6. ▪ 相關詞條

recv()介紹

int recv(SOCKET s, char FAR*buf, int len, int flags);
不論是客户還是服務器應用程序都用recv函數從TCP連接的另一端接收數據。該函數的第一個參數指定接收端套接字描述符；
第二個參數指明一個緩衝區，該緩衝區用來存放recv函數接收到的數據；
第三個參數指明buf的長度；
第四個參數一般置0。
這裏只描述同步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數據，真正的接收數據是協議來完成的） [1]  。
recv函數返回其實際copy的字節數。如果recv在copy時出錯，那麼它返回SOCKET_ERROR；如果recv函數在等待協議接收數據時網絡中斷了，那麼它返回0。
注意：在Unix系統下，如果recv函數在等待協議接收數據時網絡斷開了，那麼調用recv的進程會接收到一個SIGPIPE信號，進程對該信號的默認處理是進程終止。

recv()流程

這裏只描述同步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()實例

讀數據的時候需要考慮的是當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;// 需要再次讀取
}

recv()註釋

本函數用於已連接的數據報或流式套接口進行數據的接收。
對SOCK_STREAM類型的套接口來説，本函數將返回所有可用的信息，最大可達緩衝區的大小。如果套接口被設置為線內接收帶外數據（選項為SO_OOBINLINE），且有帶外數據未讀入，則返回帶外數據。應用程序可通過調用ioctlsocket()的SOCATMARK命令來確定是否有帶外數據待讀入。
對於數據報類套接口，隊列中第一個數據報中的數據被解包，但最多不超過緩衝區的大小。如果數據報大於緩衝區，那麼緩衝區中只有數據報的前面部分，其他的數據都丟失了，並且recv()函數返回WSAEMSGSIZE錯誤。如果沒有數據待讀，那麼除非是非阻塞模式，不然的話套接口將一直等待數據的到來，此時將返回SOCKET_ERROR錯誤，錯誤代碼是WSAEWOULDBLOCK。用select()或WSAAsynSelect()可以獲知何時數據到達。
如果套接口為SOCK_STREAM類型，並且遠端“優雅”地中止了連接，那麼recv()一個數據也不讀取，立即返回。如果立即被強制中止，那麼recv()將以WSAECONNRESET錯誤失敗返回。在套接口的所設選項之上，還可用標誌位flag來影響函數的執行方式。也就是説，本函數的語義既取決於套接口選項，也取決於標誌位參數。標誌位可取下列值：

recv()值意義

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

recv()相關詞條

recvfrom(), send(), select(), WSAAsyncSelect(), socket(), read()
參考資料
  • 1.    Reddivari S, Chen Z, Nan N. ReCVisu: A tool for clustering-based visual exploration of requirements[C]// IEEE International Requirements Engineering Conference. 2012.
  • 2.    Linux Programmer's Manual RECV(2)  ．man7.org[引用日期2013-03-06]