copy a file - Maple Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Programming : Input and Output : File Manipulation : FileTools : FileTools/Copy

FileTools[Copy] - copy a file

Calling Sequence

Copy(source, destination, opt1)

Parameters

source

-

string; source filename

destination

-

string; destination filename

opt1

-

(optional) name; argument

Description

• 

The Copy(source, destination) command copies the file source to the file named destination.

• 

The Copy function returns the number of bytes copied.

• 

The optional argument force controls Copy's behavior when a file named destination exists.  If force=false then an error is raised and the copy does not occur.  This is the default behavior.  If force=true then the destination file is replaced by the copy.

• 

If source refers to a file currently opened by Maple, it is flushed before being copied.  If destination is opened by Maple, it is closed before the copy.

• 

If an error occurs during the copy, the contents of destination are unspecified.

• 

An exception is raised if source and destination are the same.

• 

An exception is raised if source is a directory.

• 

If the user does not have permission to perform the operation, an exception is raised.

Examples

FileTools[Text]WriteLinetestfile,this is a test

15

(1)

FileTools[Text]Closetestfile

FileTools[Copy]testfile,testfile2

15

(2)

FileTools[Text]ReadLinetestfile

this is a test

(3)

FileTools[Text]ReadLinetestfile2

this is a test

(4)

FileTools[Remove]testfile

FileTools[Remove]testfile2

See Also

file_types, FileTools, FileTools[Binary][Close], FileTools[Binary][Open], FileTools[Remove], FileTools[Text][Close], FileTools[Text][Open], FileTools[Text][ReadLine], FileTools[Text][WriteLine], IO_errors


Download Help Document

Was this information helpful?



Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam