libURLftpUploadFile

Typecommand
DictionaryLCS
LibraryLiveCode Script
Syntax
libURLftpUploadFile <filePath>, <uploadURL> [, <callbackMessage>]
Associationsinternet library
Summary

Uploads a file to an Internet server asynchronously via FTP.

Introduced2.0
OSmac, windows, linux
Platformsdesktop, server
Parameters
NameTypeDescription
filePath

The filePath specifies the name and location of the file you want to upload. If you specify a name but not a location, LiveCode assumes the file is in the defaultFolder.

uploadURL

The uploadURL specifies the server and location to upload to, in the form of an FTP URL.

callbackMessage

The name of a message to send after the file is uploaded.

Example
libURLftpUploadFile "/Disk/test.data","ftp://ftp.example.org/test"
libURLftpUploadFile myFile,field "FTP URL","uploadDone"
RelatedProperty: script
Message: startup, openBackground, preOpenStack, openStack, preOpenCard
Library: Internet library, library
Keyword: URL, ftp, file
Glossary: LiveCode custom library, application, main stack, handler, upload, Standalone Application Settings, message, standalone application, binary, parameter, server, command, object
Function: files, URLStatus
Command: libURLftpUpload, libURLDownloadToFile, put, group
Securitynetwork
Description

Use the libURLftpUploadFile command to put a file on a server.

The libURLftpUploadFile command transfers the data directly from the file to the server. Unlike libURLftpUpload (or the put command used with an FTP URL), the data does not all need to be in memory at once, so this command is a better choice for large files.

The libURLftpUploadFile command transfers the file in binary mode.

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

Important: The libURLftpUploadFile command 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 pane of the Standalone Application Settings window, make sure the "Internet" script library is selected.

Tagsnetworking