FTPSize (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Timeout
Internet browser
Rights of users
Relative and absolute path
Required permissions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

FTPSize (Function)

In french: FTPTaille

Returns the size (in bytes) of a file found on an FTP server (File Transfer Protocol).

Versions 15 and later

This function is now available for Android applications.

New in version 15

This function is now available for Android applications.

Versions 18 and later

This function is now available in Android Widget mode.

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

This function is now available for iPhone/iPad applications.

New in version 18

This function is now available in Android Widget mode.

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

This function is now available for iPhone/iPad applications.

This function is now available in Android Widget mode.

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

This function is now available for iPhone/iPad applications.

Example

See additional examples

// Find out the size of "/Documents/File.Doc" file
// found on the FTP server
ResSize = FTPSize(7, "/Documents/File.DOC")

Syntax

Finding out the size of last file that was consulted Hide the details

<Result> = FTPSize()

<Result>: Integer

Size (in bytes) of the last file consulted via one of the following FTP functions: FTPAttribute, FTPDate, FTPTime, FTPListFile, FTPGet.
-1 if an error occurred. To find out the name of the error, use the function ErrorInfo with the constant errMessage.
Remark: Unlike the syntax 2, no request is sent to the server. Therefore, this syntax is recommended whenever possible.

Finding out the size of specified file Hide the details

<Result> = FTPSize(<Connection identifier> , <File name>)

<Result>: Integer

Size (in bytes) of specified file,
-1 if an error occurred. To get the details of the error, use ErrorInfo with the errMessage constant.

<Connection identifier>: Integer

Connection identifier, returned by FTPConnect.
This parameter is a Variant parameter.

<File name>: Character string (with quotes)

Name and full (or relative) path of file to use. The different path sections are separated by "slashes" ("/").

Remarks

Timeout

By default, all the FTP functions fail if the FTP server does not respond within 20 seconds. This timeout can be modified with FTPConnect when connecting to the FTP server.

Internet browser

FTPSize requires Internet Explorer version 3 or later.

If a problem occurs, we recommend that you run a test with the browser by directly passing a link such as ftp://server/... If a problem occurs with Internet Explorer (with a UNIX server for example), use FTPCommand directly.

Rights of users

Only a user who has read rights on the FTP server can get information about the files or the directories found on an FTP server. In most cases, the read rights are granted to the "anonymous" users.

Relative and absolute path

The notions of relative path and absolute path are very important in an FTP application.

A path starting with a slash is considered as being an absolute path: it is the path in relation to the root of the FTP server (parameter specific to the server).
ex: /ad/user/JULIA
A path not starting with a slash is considered as being a relative path, which means a path given in relation to the current directory. This current directory can be returned or modified by FTPCurrentDir.

When connecting to an FTP site, the initial directory (the "home directory" of the user) is not necessarily found at the root of the FTP server. Therefore, we recommend that you use relative paths.

Required permissions

The call to this function modifies the permissions required by the application.
Required permission : INTERNET
This permission allows the applications to open the network sockets.

Component: wd260com.dll