unload

Typecommand
DictionaryLCS
LibraryLiveCode Script
Syntax
unload [URL] <cachedURL>
Summary

Removes a file that was placed in the local cache by the load command, or cancels a download or upload in progress.

Introduced1.0
OSmac, windows, linux, web
Platformsdesktop, server
Parameters
NameTypeDescription
cachedURL

Any URL in the cachedURLs or any URL whose transfer was started with the libURLftpUpload, libURLftpUploadFile, or libURLDownloadToFile command.

Example
unload URL "http://www.example.com"
unload URL (line 1 of the cachedURLs)
unload URL "ftp://ftp.example.org/newfiles/latest.txt"
Values
NameTypeDescription
The result

If the cachedURL is not in the cache and not currently being uploaded or downloaded, the result function is set to "can't find url".

RelatedKeyword: URL, file, ftp, http
Command: revUnloadSpeech, libURLftpUpload, libURLDownloadToFile, get, load
Function: result, cachedURLs, URLStatus
Control Structure: function
Glossary: non-blocking, upload, download, cache, container, expression, URL, command, keyword
Securitynetwork
Description

Use the unload command to release memory used by a cached URL when you no longer need it.

If the cachedURL is still being downloaded with the load command, the unload command cancels the download.

The unload command can be used to cancel any non-blocking FTP or HTTP file transfer in progress, but it does not cancel file transfers that were initiated by using a URL container in an expression or by putting something into a URL.

The unload command removes the cachedURL from the URLStatus function. This includes URLs that have been uploaded with the libURLftpUpload command, as well as those that have been cached with the load command.

Note: You can use a URL with the URL keyword even after it has been unloaded from the cache, but caching speeds up access to the URL.

Tagsnetworking