unload

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

# Metadata

Platforms: desktop, server OS: mac, windows, linux, web Introduced: 1.0 Security: network

# Syntax

unload [URL] cachedURL

# Params

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

# Examples

unload URL "http://www.example.com"

unload URL (line 1 of the cachedURLs)

unload URL "ftp://ftp.example.org/newfiles/latest.txt"

# Description

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

If the cachedURL is still being download 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 upload with the libURLftpUpload command, as well as those that have been cache with the load command.

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

# Tags

networking,

# See

- **keyword:** 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