copy_filecopy_fileCopyFileCopyFile (Operator)
Name
copy_filecopy_fileCopyFileCopyFile — Copy a file to a new location.
Signature
Description
copy_filecopy_fileCopyFileCopyFileCopyFile copies SourceFileSourceFileSourceFileSourceFilesourceFile to DestinationFileDestinationFileDestinationFileDestinationFiledestinationFile.
Existing files are silently overwritten. The file attributes of
SourceFileSourceFileSourceFileSourceFilesourceFile are kept.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
SourceFileSourceFileSourceFileSourceFilesourceFile (input_control) filename.read → HTupleHTupleHtuple (string) (string) (HString) (char*)
File to be copied.
DestinationFileDestinationFileDestinationFileDestinationFiledestinationFile (input_control) filename.write → HTupleHTupleHtuple (string) (string) (HString) (char*)
Target location.
Result
copy_filecopy_fileCopyFileCopyFileCopyFile returns the value 2 (H_MSG_TRUE) if the file could be copied.
Otherwise, an exception is raised.
Module
Foundation