跳轉到內容

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

華夏公益教科書