Robo-FTP User's Guide > Script Programming > Script Commands > All Script Commands > APPEND

Syntax	APPEND	[ src file ] [ dest file ]
Arguments:	[ src name ]	Variable or string defining a file or path name; if no path is defined Robo-FTP’s working folder is used. Wildcards are supported.
	[ dest name ]	Variable or string defining a file or path name; if no path is defined Robo-FTP’s working folder is used.
Options:	/subdirs	When appending multiple files search sub directories for source files.
	/allowerrors	When appending multiple files continue to next file if one file has an i/o error on append.

Use this script command to append the source file to the destination file.

For example, the following appends a file to an existing file named file2 in a different folder.

APPEND "c:\test\file" "c:\test2\file2"

If test2 is an existing folder, the following appends a file to a file of the same name in a different folder.

APPEND "c:\test\file" "c:\test2"

Otherwise, file is appended to a file named test2 in the root folder of drive C:.

If appending multiple files to one output file wild cards may be used in the source. Wildcards are not permitted in the destination. The files are ordered by name when appended this way.

APPEND "c:\test\*" "c:\test2\file2"

The following example differs only from the above in that all files in "C:\test" as well as their subdirectories will be appended to the same output file:

APPEND "c:\test\*" "c:\test2\file2" /subdirs

In any case where the destination file does not previously exist, the APPEND command performs a COPY function.

After any source files have been appended to a destination file, the %copyfiles internal script variable is automatically populated with the source path of all such files.

Related command(s): COPY, RENAME, MOVE, DELETE, DOSCMD, WRITEFILE, WORKINGDIR, Using the %copyfiles Variable