BlitzMax/Modules/Networking/Sockets
函数 CreateUDPSocket:TSocket()
描述: 创建一个 UDP 套接字
返回值: 一个新的套接字
信息: 新的套接字未绑定到任何本地或远程地址。
函数 CreateTCPSocket:TSocket()
描述: 创建一个 TCP 套接字
返回值: 一个新的套接字
信息: 新的套接字未绑定到任何本地或远程地址。
函数 CloseSocket( socket:TSocket )
描述: 关闭套接字
信息: 所有套接字最终都应该关闭。一旦关闭,套接字就无法再使用。
函数 BindSocket( socket:TSocket,localPort )
描述: 将套接字绑定到本地端口
返回值: 如果成功,则为 True,否则为 False
信息: 如果 localPort 为 0,则会分配一个新的本地端口。如果 localPort 不为 0,则如果应用程序已绑定到 localPort,BindSocket 将失败。
函数 ConnectSocket( socket:TSocket,remoteIp,remotePort )
描述: 将套接字连接到远程 IP 和端口
返回值: 如果成功,则为 True,否则为 False
信息: 对于 UDP 和 TCP 套接字,如果无法访问指定的 IP 地址,则 ConnectSocket 将失败。
对于 TCP 套接字,如果远程端口没有正在监听的应用程序,则 ConnectSocket 也将失败。
函数 SocketListen( socket:TSocket,backlog=0 )
描述: 在套接字上开始监听
信息: 指定的套接字必须是 TCP 套接字,并且必须已绑定到本地端口。
函数 SocketAccept:TSocket( socket:TSocket,timeout=0 )
描述: 接受监听套接字上的新连接
返回值: 一个新的套接字,或者如果在指定超时时间内没有建立连接,则返回 Null
信息: 指定的套接字必须是 TCP 套接字,并且必须处于监听状态。
函数 SocketConnected( socket:TSocket )
描述: 获取套接字连接状态
返回值: 如果套接字已连接,则为 True
信息: SocketConnected 允许您确定 TCP 连接是否仍然有效或已被远程关闭。
SocketConnected 应该只用于已通过 ConnectSocket 或 SocketAccept 连接的 TCP 套接字。
函数 SocketReadAvail( socket:TSocket )
描述: 获取套接字中可用于读取的字节数
返回值: 在不导致套接字阻塞的情况下可以读取的字节数
函数 SocketLocalIP( socket:TSocket )
描述: 获取套接字的本地 IP
函数 SocketLocalPort( socket:TSocket )
描述: 获取套接字的本地端口
函数 SocketRemoteIP( socket:TSocket )
描述: 获取套接字的远程 IP
函数 SocketRemotePort( socket:TSocket )
描述: 获取套接字的远程端口
函数 DottedIP$( ip )
描述: 将 IP 地址转换为点分十进制字符串
返回值: IP 地址的点分十进制字符串版本
函数 HostIp( HostName$,index=0 )
描述: 将主机名转换为 IP 地址
返回值: 主机 IP 地址,如果找不到主机,则返回 0
函数 HostIps:Int[]( HostName$ )
描述: 获取主机名的所有 IP 地址
返回值: 主机 IP 数组,如果找不到主机,则返回 Null
Function HostName$( HostIp )
描述: 将主机IP地址转换为名称
返回: 主机名称,如果未找到主机则返回Null