RHTTP_GET Function

Sends an HTTP GET request. Returns an error string (empty if no error).

Syntax

RHTTP_GET(request, path, query)

Syntax Elements

request

Either an initialised HTTP request (see RHTTP_INIT_REQUEST) or a variable containing an empty string.

path

Path to data on a server (e.g. /index.html).

query

Optional. Any valid query string for the path (e.g. id=1234), or an empty string if not required).

If path is a full URL (that is, starting with http:// and including the host and, optionally, the port) then request can be an empty string ; in this case the request is initialised from the URL. Similarly, if request is an initialised HTTP request, the host (and port) from the URL override the values in the request header.

If path is a simple directory path, request must be an initialised request.

If the request has been used before, path may be relative to the last RHTTP_GET (that is, it does not have to start with "/").

Operation

Using RHTTP_GET on an active request returns an error.