FTPConnectionRemoteInputFile - OmniMark function

function

FTPConnectionRemoteInputFile

Related Concepts

Other Library Functions

Library: FTP
Include: omftp.xin

Declaration

  define external source function FTPConnectionRemoteInputFile
                          value FTPConnection this-FTPConnection
                   file   value stream remote-filename

Purpose

This is an external source function for reading a remote file on an FTP server. The FTP connection is locked during the lifetime of this source. Any library call that uses the connection will signal an exception while the source is active. Error inquiry functions and the close functions are exceptions and are allowed while the source is active.

Arguments:

"this-FTPConnection" is an opaque object of type FTPConnection.
"remote-filename" is the name of the file you want to read on the server.

Examples:

  ; read a remote file and put it to #current-output
  output FTPConnectionRemoteInputFile MyCon file "test.dat"

  ; submit a remote file to a set of rules that count letters
  set lc to 0  ; this is a global counter declared earlier
  using group lcount submit FTPConnectionRemoteInputFile MyCon file "test.dat"
  output "Letter-count = %d(lc)%n"
  ...

[CONTENTS] [CONCEPTS] [SYNTAX] [LIBRARIES] [SAMPLES] [ERRORS] [INDEX]

Generated: April 21, 1999 at 2:01:07 pm
If you have any comments about this section of the documentation, send email to [email protected]