http object
This method initiates the retrieval of a URL from the Internet.
string get(string url)
Parameters:
url
The URL of the file on the Internet that should be retrieved.
Return value:
A blank string on success, or an error description or blank string on failure (see remarks).
Remarks:
This method will send what is known as a GET request. A GET request is used in most cases when a normal URL is being visited. The URL given may contain so called GET parameters, which are used to pass small amounts of data to the server.
The URL may not contain any special characters such as spaces or similar. If you wish to include such characters, always encode the URL by calling the url_encode function before attempting to retrieve it from the Internet.
If the http server to which the URL points uses a port other than 80, you will need to include the port after the host name proceeded by a colon. The path on the server (if any) should then follow, proceeded by a slash. Such a URL might look like http://myserver.com:8080/myfile.html.
If multiple requests are made with URL's pointing to the same server, the http object will attempt to keep the connection alive for a short while which results in a dramatic speed increase for subsequent requests.
If the network subsystem fails to initialize, the get_last_error function will return -27 and the returned string will be blank.
If an Internet related error occurs, the get_last_error function will return -29 and the returned string will contain a textual description of the error. This means that you should always call get_last_error after initiating a request.
This method can be used to retrieve both binary and textual data.
The http object is asynchronous, which means that it does not wait for any data before returning. To retrieve data from the server, you must continuously call the request method until the progress boolean property reports false.
Example:

    // Retrieve the contents of the index page at blastbay.com.

    void main()
    {
    http download;
    string body=download.get("http://www.blastbay.com/");
    if(get_last_error()!=0)
    {
    alert("Error", "An error occured.\r\nDescription: " + body + "");
    }
    else
    {
    while(download.progress)
    {
    body+=download.request();
    wait(5);
    }
    clipboard_copy_text(body);
    alert("Success", "The data was retrieved and has been copied to your clipboard.");
    }
    }