_CONNECTIONADDRESS - mkilgore/QB64pe GitHub Wiki

The _CONNECTIONADDRESS function returns a connected user's STRING IP address value.

Syntax

result$ = _CONNECTIONADDRESS[$](connectionHandle&)

Description

  • The handle can come from the _OPENHOST, OPENCLIENT or _OPENCONNECTION QB64 TCP/IP functions.
  • For HOSTs: It may return "TCP/IP:8080:213.23.32.5" where 8080 is the port it is listening on and 213.23.32.5 is the global IP address which any computer connected to the internet could use to locate your computer. If a connection to the internet is unavailable or your firewall blocks it, it returns your 'local IP' address (127.0.0.1). You might like to store this address somewhere where other computers can find it and connect to your host. Dynamic IPs which can change will need to be updated.
  • For CLIENTs: It may return "TCP/IP:8080:213.23.32.5" where 8080 is the port it used to connect to the listening host and 213.23.32.5 is the IP address of the host name it resolved.
  • For CONNECTIONs (from clients): It may return "TCP/IP:8080:34.232.321.25" where 8080 was the host listening port it connected to and 34.232.321.25 is the IP address of the client that connected. This is very useful because the host can log the IP address of clients for future reference (or banning, for example).
  • The $ sygil is optional for compatibility with older versions.

Examples

Example: A Host logging new chat clients in a Chat program. See the _OPENHOST example for the rest of the code used.

newclient = _OPENCONNECTION(host) ' receive any new client connection handles
IF...THEN newclient THEN
  numclients = numclients + 1 ' increment index
  Users(numclients) = newclient ' place handle into array
  IP$ = _CONNECTIONADDRESS(newclient)
  PRINT IP$ + " has joined." ' displayed to Host only
  PRINT (file statement), IP$, numclients ' print info to a log file
  PRINT (file statement)Users(numclients),"Welcome!" ' from Host to new clients only
END IF '' ''

Explanation: The function returns the new client's IP address to the IP$ variable. Prints the IP and the original login position to a log file. The information can later be used by the host for referance if necessary. The host could set up a ban list too.

See also


Navigation:
Go to Keyword Reference - Alphabetical
Go to Keyword Reference - By usage
Go to Main WIKI Page
⚠️ **GitHub.com Fallback** ⚠️