簡述
從一個
套接口接收數據。
表頭文件：
#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節具體討論）。
返回值：
錯誤代碼：
WSANOTINITIALISED：在使用此API之前應首先成功地調用WSAStartup()。
WSAENETDOWN：WINDOWS
套接口實現檢測到網絡子系統失效。
WSAENOTCONN：
套接口未連接。
WSAEINTR：阻塞進程被WSACancelBlockingCall()取消。
WSAEINPROGRESS：一個阻塞的WINDOWS
套接口調用正在運行中。
WSAENOTSOCK：描述字不是一個
套接口。
WSAEOPNOTSUPP：指定了MSG_OOB，但
套接口不是SOCK_STREAM類型的。
WSAEWOULDBLOCK：
套接口標識為非阻塞模式，但接收操作會產生阻塞。
WSAEMSGSIZE：數據報太大無法全部裝入
緩沖區，故被剪切。
WSAEINVAL：
套接口未用bind()進行捆綁。
WSAECONNABORTED：由於超時或其他原因，虛電路失效。
WSAECONNRESET：遠端強制中止了虛電路。
linux版本:
第四個參數：
MSG_DONTROUTE 繞過路由表查找。
MSG_DONTWAIT 僅本操作非阻塞。
MSG_OOB 發送或接收帶外數據。
MSG_PEEK 窺看外來消息。
MSG_WAITALL 等待所有數據。
返回值：
若無錯誤發生，recv()返回讀入的字節數。如果連接已中止，返回0。如果發生錯誤，返回-1，
應用程序可通過perror()獲取相應錯誤信息。