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