socket编程常用接口列表

API接口讲解

int socket(int addressFamily, int type,

int protocol)

int close(int socketFileDescriptor)

socket 创建并初始化 socket，返回该 socket 的文件描述符，如果描述符为 -1 表示创建失败。

close 关闭 socket。

通常参数 addressFamily 是 IPv4(AF_INET) 或 IPv6(AF_INET6)。type 表示 socket 的类型，通常是流stream(SOCK_STREAM) 或数据报文datagram(SOCK_DGRAM)。protocol 参数通常设置为0，以便让系统自动为选择我们合适的协议，对于 stream socket 来说会是 TCP 协议(IPPROTO_TCP)，而对于 datagram来说会是 UDP 协议(IPPROTO_UDP)。

int bind(int socketFileDescriptor,

sockaddr *addressToBind,

int addressStructLength)

将 socket 与特定主机地址与端口号绑定，成功绑定返回0，失败返回 -1。

成功绑定之后，根据协议(TCP/UDP)的不同，我们可以对 socket 进行不同的操作：

UDP：因为 UDP 是无连接的，绑定之后就可以利用 UDP socket 传送数据了。

TCP：而 TCP 是需要建立端到端连接的，为了建立 TCP 连接服务器必须调用 listen(int socketFileDescriptor, int backlogSize) 来设置服务器的缓冲区队列以接收客户端的连接请求，backlogSize 表示客户端连接请求缓冲区队列的大小。当调用 listen 设置之后，服务器等待客户端请求，然后调用下面的 accept 来接受客户端的连接请求。

int accept(int socketFileDescriptor,

sockaddr *clientAddress, int

clientAddressStructLength)

接受客户端连接请求并将客户端的网络地址信息保存到 clientAddress 中。

当客户端连接请求被服务器接受之后，客户端和服务器之间的链路就建立好了，两者就可以通信了。

int connect(int socketFileDescriptor,

sockaddr *serverAddress, int

serverAddressLength)

客户端向特定网络地址的服务器发送连接请求，连接成功返回0，失败返回 -1。

当服务器建立好之后，客户端通过调用该接口向服务器发起建立连接请求。对于 UDP 来说，该接口是可选的，如果调用了该接口，表明设置了该 UDP socket 默认的网络地址。对 TCP socket来说这就是传说中三次握手建立连接发生的地方。

注意：该接口调用会阻塞当前线程，直到服务器返回。

hostent* gethostbyname(char *hostname)

使用 DNS 查找特定主机名字对应的 IP 地址。如果找不到对应的 IP 地址则返回 NULL。

int send(int socketFileDescriptor, char

*buffer, int bufferLength, int flags)

通过 socket 发送数据，发送成功返回成功发送的字节数，否则返回 -1。

一旦连接建立好之后，就可以通过 send/receive 接口发送或接收数据了。注意调用 connect 设置了默认网络地址的 UDP socket 也可以调用该接口来接收数据。

int receive(int socketFileDescriptor, char

*buffer, int bufferLength, int flags)

 从 socket 中读取数据，读取成功返回成功读取的字节数，否则返回 -1。

一旦连接建立好之后，就可以通过 send/receive 接口发送或接收数据了。注意调用 connect 设置了默认网络地址的 UDP socket 也可以调用该接口来发送数据。

int sendto(int socketFileDescriptor,

char *buffer, int bufferLength, int

flags, sockaddr *destinationAddress, int

destinationAddressLength)

通过UDP socket 发送数据到特定的网络地址，发送成功返回成功发送的字节数，否则返回 -1。

由于 UDP 可以向多个网络地址发送数据，所以可以指定特定网络地址，以向其发送数据。

int recvfrom(int socketFileDescriptor,

char *buffer, int bufferLength, int

flags, sockaddr *fromAddress, int

*fromAddressLength)

从UDP socket 中读取数据，并保存发送者的网络地址信息，读取成功返回成功读取的字节数，否则返回 -1 。

由于 UDP 可以接收来自多个网络地址的数据，所以需要提供额外的参数，以保存该数据的发送者身份。