Downloads the file specified by a URL to a cache where it can be used by another handler.
Syntax:
load [URL] <url> [with message <callbackMessage>]
Examples:
load URL "http://www.example.com/index.html"
load URL myURL with message "downloadComplete"
load URL tMyUrl with message "myUrlDownloadFinished"
on myUrlDownloadFinished answer "Download Complete" with "Okay" end myUrlDownloadFinished
Use the load command to pre-fetch a file from the Internet in order to speed up access when using it in an expression with the URL keyword.
To use a file that has been downloaded by the load command, refer to it using the URL keyword as usual. When you request the original URL, LiveCode uses the cached file automatically.
The callbackMessage is sent to the object(glossary) whose script contains the load command, after the URL is loaded, so you can handle the callbackMessage to perform any tasks you want to delay until the URL has been cached. Two parameters are sent with the message : the URL and the URLStatus of the file.
The load command is non-blocking, so it does not stop the current handler while the download is completed. The handler continues while the load command downloads the URL in the background. You can monitor the download by checking the URLStatus function periodically.
load URL myURL wait until the URLStatus of myURL is cached -- DON'T DO THIS
The file is downloaded into a local cache. It does not remain available
after the application quits; the purpose of the cache is to speed up
access to the specified URL, not to store it permanently. You can use a
URL even if it is not in the cache, so use of the load command is
optional.
Cached files consume memory. To release this memory after you are finished with a URL, use the unload (command) command to remove it from the cache.
The load command is part of the Internet library on desktop platforms. To ensure that the command works in a desktop standalone application, you must include this custom library when you create your standalone. In the Inclusions pane of the Standalone Application Settings window, make sure the "Internet" script library is selected.
On iOS and Android, the load command is implemented in the engine. Therefore the Internet library is not needed to ensure the command works in a mobile standalone application. If included, the Internet library implementation will be used instead of the engine implementation.
When specifying URLs for iOS or Android, you must use the appropriate form that conforms to [RFC 1738](https://tools.ietf.org/html/rfc1738). Ensure that you URLEncode any username and password fields appropriately for FTP URLs.
Parameters:
- url: Any valid http or ftp URL.
- callbackMessage: The name of a message to send after the URL is loaded.
See also: libURLDownloadToFile (command),get (command),load (command),group (command),function (control structure),libURLLastRHHeaders (function),URLEncode (function),files (function),libURLErrorData (function),URLStatus (function),cachedURLs (function),Internet library (library),library (library),startup (message),openBackground (message),preOpenStack (message),openStack (message),preOpenCard (message),script (property),