mirror of
https://github.com/QB64Official/qb64.git
synced 2024-09-28 11:17:47 +00:00
25 lines
990 B
Text
25 lines
990 B
Text
{{DISPLAYTITLE:_CONNECTED}}
|
|
The [[_CONNECTED]] function returns the status of a TCP/IP connection handle.
|
|
|
|
|
|
{{PageSyntax}}
|
|
:{{Parameter|result&}} = [[_CONNECTED]]({{Parameter|connectionHandle&}})
|
|
|
|
|
|
{{PageDescription}}
|
|
* The handle can come from the [[_OPENHOST]], [[OPENCLIENT]] or [[_OPENCONNECTION]] QB64 TCP/IP functions.
|
|
* Returns -1 if still connected or 0 if connection has ended/failed.
|
|
* Do not rely solely on this function to check for ending communication.
|
|
* Use "time-out" checking as well and [[CLOSE]] any suspect connections.
|
|
* If this function indicates the handle is not connected, any unread messages can still be read using [[GET (TCP/IP statement)|GET #]].
|
|
* Even if this function indicates the handle is not connected, it is important to [[CLOSE]] the connection anyway or important resources cannot be reallocated.
|
|
|
|
{{PageSeeAlso}}
|
|
* [[_OPENCONNECTION]]
|
|
* [[_OPENHOST]]
|
|
* [[_OPENCLIENT]]
|
|
* [[_CONNECTIONADDRESS$]]
|
|
* [[Downloading Files]]
|
|
|
|
|
|
{{PageNavigation}}
|