Error getting tags :
error 404Error getting tags :
error 404 libURLDownloadToFile | revDocs | RunRev
Welcome Guest (Log in)
Product Edition
Expander triangle

libURLDownloadToFile downloadURL,filePath[,callbackMessage]

Desktop, Web and Server
Platform Support
MacOS,Mac OS X,Windows,Linux
Downloads a file from an Internet server asynchronously via FTP, HTTP or HTTPS

libURLDownloadToFile "",it
libURLDownloadToFile myFile,newPath,"downloadComplete"

Additional Comments
Expander triangle

Use the libURLDownloadToFile command to download a file from an FTP Server or Web Server.


The downloadURL specifies the server and file to download, in the form of an FTP, HTTP or HTTPS url.

The filePath specifies the name and location to save the downloaded file in. If you specify a name but not a location, Revolution assumes the file is in the defaultFolder.

The callbackMessage is the name of a message to send after the download is finished.


The libURLDownloadToFile command transfers the data directly from the file to the server. Unlike simply using the put command to put the contents of a URL into a file, using the libURLDownloadToFile command does not load all the data into memory at once, so this command is a better choice for large files.

The libURLDownloadToFile command transfers the file in binary mode.

The callbackMessage is sent to the object whose script contains the libURLDownloadToFile command, after the download is complete, so you can handle the callbackMessage to perform any tasks you want to delay until the file has been downloaded. Two parameters are sent with the message: the URL and the URLStatus of the file.

Tip: On Mac OS and OS X systems, the new file'screator signature and file type is set to the value specified in the fileTypeproperty.

Important! The libURLDownloadToFilecommand is part of the Internet library. To ensure that the command works in a standalone application, you must include this custom library when you create your standalone. In the Inclusions section of the Standalone Application Settings window, make sure "Internet Library" is selected in the list of script libraries.

Note: When included in a standalone application, the Internet library is implemented as a hidden group and made available when the group receives its first openBackground message. During the first part of the application's startup process, before this message is sent, the libURLDownloadToFilecommand is not yet available. This may affect attempts to use this command in startup, preOpenStack, openStack, or preOpenCardhandlers in the main stack. Once the application has finished starting up, the library is available and the libURLDownloadToFilecommand can be used in any handler.

User Comments
Expander triangle