select()

select()

　　简述：
　　确定一个或多个套接口的状态，如需要则等待。
　　#include
　　int PASCAL FAR select( int nfds, fd_set FAR* readfds,
　　fd_set FAR* writefds, fd_set FAR* exceptfds,
　　const struct timeval FAR* timeout);
　　nfds：本参数忽略，仅起到兼容作用。
　　readfds：（可选）指针，指向一组等待可读性检查的套接口。
　　writefds：（可选）指针，指向一组等待可写性检查的套接口。
　　exceptfds：（可选）指针，指向一组等待错误检查的套接口。
　　timeout：select()最多等待时间，对阻塞操作则为NULL。
　　注释：
　　本函数用于确定一个或多个套接口的状态。对每一个套接口，调用者可查询它的可读性、可写性及错误状态信息。用fd_set结构来表示一组等待检查的套接口。在调用返回时，这个结构存有满足一定条件的套接口组的子集，并且select()返回满足条件的套接口的数目。有一组宏可用于对fd_set的操作，这些宏与Berkeley Unix软件中的兼容，但内部的表达是完全不同的。
　　readfds参数标识等待可读性检查的套接口。如果该套接口正处于监听listen()状态，则若有连接请求到达，该套接口便被标识为可读，这样一个accept()调用保证可以无阻塞完成。对其他套接口而言，可读性意味着有排队数据供读取。或者对于SOCK_STREAM类型套接口来说，相对于该套接口的虚套接口已关闭，于是recv()或recvfrom()操作均能无阻塞完成。如果虚电路被“优雅地”中止，则recv()不读取数据立即返回；如果虚电路被强制复位，则recv()将以WSAECONNRESET错误立即返回。如果SO_OOBINLINE选项被设置，则将检查带外数据是否存在（参见setsockopt()）。
　　writefds参数标识等待可写性检查的套接口。如果一个套接口正在connect()连接（非阻塞），可写性意味着连接顺利建立。如果套接口并未处于connect()调用中，可写性意味着send()和sendto()调用将无阻塞完成。〔但并未指出这个保证在多长时间内有效，特别是在多线程环境中〕。
　　exceptfds参数标识等待带外数据存在性或意味错误条件检查的套接口。请注意如果设置了SO_OOBINLINE选项为假FALSE，则只能用这种方法来检查带外数据的存在与否。对于SO_STREAM类型套接口，远端造成的连接中止和KEEPALIVE错误都将被作为意味出错。如果套接口正在进行连接connect()（非阻塞方式），则连接试图的失败将会表现在exceptfds参数中。
　　如果对readfds、writefds或exceptfds中任一个组类不感兴趣，可将它置为空NULL。
　　在winsock.h头文件中共定义了四个宏来操作描述字集。FD_SETSIZE变量用于确定一个集合中最多有多少描述字（FD_SETSIZE缺省值为64，可在包含winsock.h前用#define FD_SETSIZE来改变该值）。对于内部表示，fd_set被表示成一个套接口的队列，最后一个有效元素的后续元素为INVAL_SOCKET。宏为：
　　FD_CLR(s,*set)：从集合set中删除描述字s。
　　FD_ISSET(s,*set)：若s为集合中一员，非零；否则为零。
　　FD_SET(s,*set)：向集合添加描述字s。
　　FD_ZERO(*set)：将set初始化为空集NULL。
　　timeout参数控制select()完成的时间。若timeout参数为空指针，则select()将一直阻塞到有一个描述字满足条件。否则的话，timeout指向一个timeval结构，其中指定了select()调用在返回前等待多长时间。如果timeval为{0,0}，则select()立即返回，这可用于探询所选套接口的状态。如果处于这种状态，则select()调用可认为是非阻塞的，且一切适用于非阻塞调用的假设都适用于它。举例来说，阻塞钩子函数不应被调用，且WINDOWS套接口实现不应yield。
　　返回值：
　　select()调用返回处于就绪状态并且已经包含在fd_set结构中的描述字总数；如果超时则返回0；否则的话，返回SOCKET_ERROR错误，应用程序可通过WSAGetLastError()获取相应错误代码。
　　错误代码：
　　WSANOTINITIALISED：在使用此API之前应首先成功地调用WSAStartup()。
　　WSAENETDOWN：WINDOWS套接口实现检测到网络子系统失效。
　　WSAEINVAL：超时时间值非法。
　　WSAEINTR：通过一个WSACancelBlockingCall()来取消一个（阻塞的）调用。
　　WSAEINPROGRESS：一个阻塞的WINDOWS套接口调用正在运行中。
　　WSAENOTSOCK：描述字集合中包含有非套接口的元素。