jit.uldl Reference

Internet upload/download

jit.uldl

Description

The jit.uldl object provides asynchronous file upload and download. Download is possible from http:// , https:// , ftp:// , and file:/// URLs. Upload is only possible to ftp:// URLs.

Examples

Matrix Operator

matrix inputs:0, matrix outputs:1
Name IOProc Planelink Typelink Dimlink Plane Dim Type
out n/a 1 1 1 1 1 char

More about Matrix Operators

The Jitter MOP

MOP Arguments

MOP Attributes

MOP Messages

Attributes

defaultdir [symbol]

The default download directory (default = default path)

convert [int]

When the flag is set (the default), the jit.uldl object will convert the line breaks in downloaded data (DOS or Unix-style) to Macintosh-style line breaks.

dir_list [int]

List remote directories flag (FTP-only, default = 0)
When the flag is set, the jit.uldl object will attempt to list the contents of a remote directory, if the URL specifies one. This feature is only available for FTP URLs.

WINDOWS USERS: This functionality is not currently available.

dirlist [int]

List remote directories flag (FTP-only, default = 0)
Duplicates the functionality of the dir_list attribute.

passive [int]

When the flag is set (the default) FTP connections will be made using passive mode.

password [symbol]

The password, if required

percent [int]

Upload/download percent report flag (default = 0)
When the flag is set, the periodic indications of a download operation's progress (as a floating point number between 0 and 1) are reported from the right outlet.

report [int]

The upload/download status report flag (default = 0)
When the flag is set, periodic status data is sent out the right outlet during data transfer operations.

url_dl [symbol]

The download URL (default = [none])

url_ul [symbol]

The upload URL (default = [none])

urldl [symbol]

The download URL (default = [none])

urlul [symbol]

The upload URL (default = [none])

username [symbol]

The username, if needed for upload and download (default = [none])

Common Box Attributes

Messages

abort

Aborts a download or upload operation in progress.

download

Arguments

URL [symbol]
Begins a download operation from the URL specified in the argument. Any data is downloaded to the default path or the directory specified by the defaultdir attribute. If no argument is given, download begins from the URL specified by the url_dl attribute. If the argument matrix is given, data will be downloaded to a Jitter matrix, and output via the jit.uldl object's left (matrix) outlet.

upload

Arguments

local-file [symbol]
URL [symbol]
Begins an upload operation from the local file specified by the first argument, to the URL specified in the second argument. If no second argument is given, upload is to the URL specified by the url_ul attribute.

See Also

Name Description
jit.qt.movie
jit.textfile