TCP客户端支持库
获取上网卡 IP
获取上网卡 IP，所有参数可省略，
如果指定目标主机与端口，则优先返回访问目标主机的网卡 IP，
主机可指定域名或 IP，建议指定稳定的主机，
端口省略则默认为 80，省略超时参数则默认为 0.3 秒
检测目标主机是否可建立 TCP 连接
如果已连接网络则返回建立链接的网卡 IP，否则返回 null
检测目标主机是否可建立 TCP 连接，所有参数可省略。
主机可指定域名或 IP，也可以指定包含多个主机的数组，
端口省略则默认为 80，省略超时参数则默认为 0.3 秒
如果可以连接任一指定的目标主机则返回建立连接的网卡 IP，
否则返回 null
tcpclientObject._onClosed = function(){
/*套接字关闭以前触发
此回调函数是标准库保留接口
用户不应使用此回调*/
}
检测到由event参数指明的网络事件后,
参数@1使用_FD_前缀的常量指定,可使用位或操作符指定多个选项
事件到达向hwnd指定句柄的窗口发送userMsgId消息,
第二次调用此函数可省略句柄以及消息ID
失败返回null,以及错误信息,
成功返回true,以及上次调用此函数指定的event参数
绑定 IP 端口。
绑定 IP 端口。
如果不指定 IP 则默认绑定 0.0.0.0。
成功返回 true，
失败返回 null,错误信息,错误代码。
同一套接字重复绑定会返回 10022（_WSAEINVAL） 错误。
重新绑定应当重新创建套接字。
这就好比一张车票只能上一次车。
不能在已经上车以后再要求车站修改车票上的上车地。
读写缓冲区大小，默认为 1MB
缓冲区如果设置的太小，会导致过于频繁的调用读写函数
关闭并释放 TCP 客户端。
如果关闭了套接字此函数返回 true
如果套接字已经关闭，此函数返回 null。
如果未显式调用此函数，
在对象析构时,将会自动调用。
已关闭的套接字不能再使用，需要重连接请重新创建套接字。
就好比用过的车票不能重复用，什么地方都有规则和限制。
创建连接。
已关闭的套接字不能再使用，需要重连接请重新创建套接字。
就好比用过的车票不能重复用，什么地方都有规则和限制。
创建连接，成功返回 true。
也可以在参数 @1 中用一个字符串同时指定 IP 和端口号,IP 与端口号使用冒号分隔。
失败返回 null ，错误信息
异步套接字始终返回 null ，在 onOpen ,onError 回调事件中判断是否连接成功
创建连接，可指定超时。
已关闭的套接字不能再使用，需要重连接请重新创建套接字。
就好比用过的车票不能重复用，什么地方都有规则和限制。
创建连接，成功返回 true。
也可以在参数 @1 中用一个字符串同时指定 IP 和端口号,IP 与端口号使用冒号分隔。
注意：超时是以秒为单位，不是毫秒！！
省略超时参数则默认值为 0.5 秒。
for(str,readSize,remainSize in tcpclientObject.eachRead() ){
/*可选指在eachRead参数中指定最大长度,
str是本次读取的字符串,readSize是读取的长度,
remainSize是剩余还没有读取的字节,
如果限定了最大长度,remainSize为0时才表示读完所有数据,
此函数不支持unRead送回的数据,也不适合于异步套接字*/
}
for(readSize,remainSize in tcpclientObject.eachReadBuffer() ){
/*可选指在eachReadBuffer参数中指定最大长度,
readSize是读取的长度,buffer的实际长度可能大于readSize,
remainSize是剩余还没有读取的字节,
如果限定了最大长度,remainSize为0时才表示读完所有数据
此函数不支持unRead送回的数据,也不适合于异步套接字*/
}
兼容aardio标准流接口
返回连接的本地IP,端口号
返回连接的远程IP,端口号
获取并同时清除套接字错误代码
获取选项
参数@1使用_SO_前缀的常量指定选项,参数@2使用结构体指定值
如果不指定参数@2,则获取一个32位整型数值,
可选用参数@3指定设置层次，默认为SOL_SOCKET
成功返回读取的结构体
套接字句柄。
关闭对象后为空值。
此值应由对象自动维护，调用者不应修改此属性
套接字是否已关闭
套接字是否已连接
最后一次调用asyncSelect应用的事件
不可手动修改此属性，应由对象自动维护
最后一次调用asyncSelect应用的窗口句柄
不可手动修改此属性，应由对象自动维护
最后一次调用asyncSelect应用的消息ID
不可手动修改此属性，应由对象自动维护
tcpclientObject.onClosed = function(){
/*套接字关闭以前触发*/
}
读取但并不移除缓冲区的数据,返回字符串
不指定参数则使用bufferSize指定的大小分配buffer并尝试读取
读取数据
此函数等待数据到达,
但如果参数未省略且不是-1,则不保证读取达到定的长度
如果要等待直到指定长度应改用 readEx 函数
读取数据
参数可以指定长度,也可以使用接收数据的结构体作为参数
参数为-1表示读到尾部,无参数表示读取一行,
使用CRLF回车换行符分行
此函数等待数据到达,
但如果参数未省略且不是-1,则不保证读取达到定的长度
接收全部数据
该函数读取直至连接关闭,应慎用该函数防止服务器保持连接无法返回
循环读取数据到动态指针内,
动态指针的使用风险较大,如果不是非常熟悉其规则,
建议不要使用此函数
对象所有read前缀的成员函数底层基本都是调用这个函数
此函数读取的数据支持调用unRead或unReadAlloc,
撤消并退回到读缓冲区
循环读取数据，直到读取结束,
循环读取数据并存入参数指定的动态指针,
返回新的指针地址和内存长度,
此函数可能更新指针地址或分配的内存大小，
必须使用返回的新指针覆盖原来保存该动态指针的变量值
循环读取数据，直到达到参数中限定的最大长度
读取长度不可指定负数,负数仅用于界面线程异步套接字
无数据返回null，
如果读取到数据则返回2个值：动态指针,内存长度
调用者必须负责调用 raw.realloc(0,动态指针)
释放返回值1返回的指针
此函数直接操作内存，效率更好
但一定要记住释放返回的内存指针
读取数据达到指定长度,参数不可省略
成功返回动态指针,数据长度,
动态指针必须用 raw.realloc 函数释放,
非必要请不要直接使用此函数,应改用 readEx 函数
此函数不可用于异步套接字
读取数据,返回 buffer 对象,
省略所有参数则读取所有数据，
参数@1可选指定一个使用 buffer 对象，
省略读取长度时取缓冲区长度，
如果参数@1指定了缓冲区,成功返回读取长度,
否则成功返回缓冲区，
失败返回null
数据尚未到达时的等待时间
此属性仅适用于界面线程异步套接字
仅在读取长度为负值是有效
读取数据达到指定长度,参数不可省略
成功返回字符串,如果套接字关闭,则返回已读取的数据
此函数不可用于异步套接字
读取一个字节的紧急数据,返回字节码
读取直到以指定的字符串结束
如果只是读取部分数据并没有获取到结束标记，第二个返回值为true
否则只会返回一个值,成功返回读取字符串,
失败返回null
读取直到以指定的字符串结束,返回值不包含结束串,
该函数每次仅读取一个字节,效率较低
读取直到以指定的字符串结束,返回值不包含结束串,
如果没有读取到数据，则循环等待，等待时继续处理界面消息
此用法仅适用于界面线程异步套接字
该函数每次仅读取一个字节,效率较低
套接字连接状态,
0 为等待连接,1 为已连接,2 为正在关闭,3 为已关闭
单次接收数据包
如果参数不指定长度，则使用bufferSize指定的长度
成功返回字符串,
失败返回null,错误代码
单次接收数据包
参数@1指定 buffer 对象,
参数@2可省略,默认为缓冲区长度,
成功返回接收的长度,
失败返回null,错误代码
是否允许端口重用
单次发送数据包
成功返回发送的数据长度,
失败返回null,错误代码
异步套接字发送缓冲区,用户不应修改此对象
设置超时,以亳秒为单位(1秒为1000毫秒)
设置选项
参数@1使用_SO_前缀的常量指定选项,参数@2使用结构体、数值、布尔值都可以
可选用参数@3指定设置层次，默认为SOL_SOCKET
成功返回true
断开连接。
参数中指定 0 为仅停止收数据，指定 1 为停止发数据。
默认值为 2 表示停止收发送数据。
此函数并不销毁套接字句柄。
已断开连接的套接字不能再使用，需要重连接请重新创建套接字。
就好比用过的车票不能重复用，什么地方都有规则和限制。
把read,readTo,readBuffer等函数读出的数据退回缓存，
注意退回数据的顺序是“后出先进”，
最后读出的应当最先退回
把readAlloc读取的动态指针退回缓存,
注意退回数据的顺序是“后出先进”，
最后读出的应当最先退回
发送数据,
支持一个或多个参数，参数支持字符串、buffer (buffer)、数值、结构体
成功返回true
发送数据,
参数@1应使用 buffer 对象,
可选使用参数2指定长度
成功返回true
绑定套接字句柄并返回TCP客户端对象
创建 TCP 客户端,
套接字为空则创建套接字,否则绑定套接字句柄,
缓冲区大小为可选参数,默认为1KB