recv()

recv()

recv()是程式語言函式。 函式原型int recv( _In_ SOCKET s, _Out_ char *buf, _In_ int len, _In_ int 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()返回的大小如果等於請求的大小,那么很有可能是緩衝區還有數據未讀完,也意味著該次事件還沒有處理完,所以還需要再次讀取:

注釋

本函式用於已連線的數據報或流式套接口進行數據的接收。

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

相關詞條

recvfrom(), send(), select(), WSAAsyncSelect(), socket(), read()

相關詞條

相關搜尋

熱門詞條

聯絡我們