Returning a pathname in normalised formΒΆ
get_client_info() |
Return client connection information |
SYNTAX
get_client_info(server, port, client_id, random_id)
Connects to the specified Sculptor server if not already connected and then returns connection information in the supplied fields.
server |
The server name. This is a text value. |
port |
The TCP/IP port number of the connection. This field should be u2 or longer. Valid port numbers are always non-zero. |
client_id |
A unique client id number allocated by the server (i4 type). Valid client id numbers are always non-zero. |
random_id |
A random id number allocated by the server (i4 type). |
Return values from the function are:
< 0 |
Cannot connect to server. |
0 |
Successful. |
> 0 |
Not used. Treat as an error. |
This function can be used in conjunction with disconnect_client() to recover after a socket error.
RELATED TOPICS |