This built-in predicate copies a source file to a destination file, the source file is the left argument and the destination file is right argument. If the destination file already exists then it is overwritten.
see also: app_dir/1 base64_decode_file/2 base64_encode_file/2 compress_file/2 current_dir/1 decompress_file/1 decompress_file/2 decrypt_file/3 delete_file/1 encrypt_file/3 exists_dir/1 exists_file/1 info_file/2 make_dir/1 md5_file/2 next_file/2 next_file/3 next_dir/2 remove_dir/1 rename_file/2 set_current_dir/1 split_fn/2 unlink_file/1 wipe_file/1
| Examples | |
| copy_file('c:\\temp\\doc.txt', 'd:\\doc2.txt'). | the file 'doc.txt' is copied from 'c:\temp\' to 'd:\doc2.txt' |
| Exceptions | |
| The argument is an empty variable | an instantiation_error exception is thrown |
| The argument Arg is not an atom enclosed by single or double quotes | a type_error(atom_singlequotes, Arg) exception is thrown |
| The File to copy cannot be opened for reading | an existence_error(file, File) exception is thrown |
| The destination File to copy to cannot be opened for writing | a permission_error(write, file, File) exception is thrown |
| A system error while copying data | a system_error(copy, file, File) exception is thrown |