跳转到内容

BlitzMax/Modules/Networking/Sockets

来自 Wikibooks,开放世界的开放书籍

CreateUDPSocket

[编辑 | 编辑源代码]

函数 CreateUDPSocket:TSocket()

描述: 创建一个 UDP 套接字

返回值: 一个新的套接字

信息: 新的套接字未绑定到任何本地或远程地址。

CreateTCPSocket

[编辑 | 编辑源代码]

函数 CreateTCPSocket:TSocket()

描述: 创建一个 TCP 套接字

返回值: 一个新的套接字

信息: 新的套接字未绑定到任何本地或远程地址。

CloseSocket

[编辑 | 编辑源代码]

函数 CloseSocket( socket:TSocket )

描述: 关闭套接字

信息: 所有套接字最终都应该关闭。一旦关闭,套接字就无法再使用。

BindSocket

[编辑 | 编辑源代码]

函数 BindSocket( socket:TSocket,localPort )

描述: 将套接字绑定到本地端口

返回值: 如果成功,则为 True,否则为 False

信息: 如果 localPort 为 0,则会分配一个新的本地端口。如果 localPort 不为 0,则如果应用程序已绑定到 localPortBindSocket 将失败。

ConnectSocket

[编辑 | 编辑源代码]

函数 ConnectSocket( socket:TSocket,remoteIp,remotePort )

描述: 将套接字连接到远程 IP 和端口

返回值: 如果成功,则为 True,否则为 False

信息: 对于 UDP 和 TCP 套接字,如果无法访问指定的 IP 地址,则 ConnectSocket 将失败。

对于 TCP 套接字,如果远程端口没有正在监听的应用程序,则 ConnectSocket 也将失败。

SocketListen

[编辑 | 编辑源代码]

函数 SocketListen( socket:TSocket,backlog=0 )

描述: 在套接字上开始监听

信息: 指定的套接字必须是 TCP 套接字,并且必须已绑定到本地端口。

SocketAccept

[编辑 | 编辑源代码]

函数 SocketAccept:TSocket( socket:TSocket,timeout=0 )

描述: 接受监听套接字上的新连接

返回值: 一个新的套接字,或者如果在指定超时时间内没有建立连接,则返回 Null

信息: 指定的套接字必须是 TCP 套接字,并且必须处于监听状态。

SocketConnected

[编辑 | 编辑源代码]

函数 SocketConnected( socket:TSocket )

描述: 获取套接字连接状态

返回值: 如果套接字已连接,则为 True

信息: SocketConnected 允许您确定 TCP 连接是否仍然有效或已被远程关闭。

SocketConnected 应该只用于已通过 ConnectSocketSocketAccept 连接的 TCP 套接字。

SocketReadAvail

[编辑 | 编辑源代码]

函数 SocketReadAvail( socket:TSocket )

描述: 获取套接字中可用于读取的字节数

返回值: 在不导致套接字阻塞的情况下可以读取的字节数

SocketLocalIP

[编辑 | 编辑源代码]

函数 SocketLocalIP( socket:TSocket )

描述: 获取套接字的本地 IP

SocketLocalPort

[编辑 | 编辑源代码]

函数 SocketLocalPort( socket:TSocket )

描述: 获取套接字的本地端口

SocketRemoteIP

[编辑 | 编辑源代码]

函数 SocketRemoteIP( socket:TSocket )

描述: 获取套接字的远程 IP

SocketRemotePort

[编辑 | 编辑源代码]

函数 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

华夏公益教科书