fgl_download()

You are here:

fgl_download()

Lycia supports transferring files between the client and the server. The built-in function is used to pass files in the server-to-client direction.

fgl_download(server_file, client_file)

where

server_file is a string standing for the path, the name and the extension of the file to be downloaded
client_file is a string standing for the file target location, name and extension after downloading

All the file names you use in your 4gl development must be platform-independent.

If you use platform-dependent names (e.g., combine upper and lower case, use colons, finish names with a full stop, etc.), please remember that they might cause different problems when you move your project to another platform.

fgl_download() allows to retrieve a file stored on the server and passes it to the client. Both arguments are required, and can specify the full path as well as the relative one.

For example, this function call may be used to get a copy of a file located on some machine at C:\Docs\Howto.doc and move it to the different location on the user's machine:

fgl_download("C:\\Docs\\Howto.doc", "Z:\\MyFiles\\Guides\\Howto.doc")

'\\' must always be used instead of "\", otherwise, the string is not treated as a path, and the function call takes no effect.

If the specified file does not exist, file transfer is not performed, and the function returns 0/FALSE. If the operation is performed successfully, the function returns 1/TRUE.

fgl_download() replaces fgl_file_to_client(), retaining the same functionality.

To pass the files from client to server, you must use fgl_upload().