Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

copyfile

Copy file or folder

Syntax

copyfile source
copyfile source destination
copyfile source destination f
status = copyfile(___)
[status,msg] = copyfile(___)
[status,msg,msgID] = copyfile(___)

Description

copyfile source copies the file or folder source to the current folder. After a successful copyfile operation, the timestamp for the new file is the same as the timestamp for source.

example

copyfile source destination copies source to the file or folder destination.

  • If source is a file, then destination can be a file or a folder.

  • If source is a folder, then destination must be a folder.

  • If source is a folder or specifies multiple files and destination does not exist, then copyfile attempts to create destination.

example

copyfile source destination f copies source to destination, even when destination is not writable. The state of the read/write attribute for destination does not change.

example

status = copyfile(___) copies the specified file or folder and returns a status of 1 if the operation is successful. Otherwise, copyfile returns 0. You can use this syntax with any of the input argument combinations in the previous syntaxes.

example

[status,msg] = copyfile(___) also returns the message text for any warning or error that occurs.

example

[status,msg,msgID] = copyfile(___) additionally returns the message ID for any warning or error that occurs.

Examples

collapse all

Copy myfile1.m from the current folder to the subfolder myFolder.

mkdir myFolder
copyfile myfile1.m myFolder

Create a copy of myfile1.m in the current folder, assigning it the name myfile2.m.

copyfile myfile1.m myfile2.m

Copy files and subfolders with names beginning with my from the current folder to the folder newFolder, where newFolder does not already exist.

copyfile my* newFolder

Copy the file myfile1.m from the current folder to the read-only folder restricted.

Create the read-only folder restricted.

mkdir restricted
fileattrib restricted -w

Copy and rename the file myfile1.m. A status of 0 shows the copy was unsuccessful.

status = copyfile('myfile1.m', 'restricted');
status
status =

  logical

   0

Copy the file myfile1.m using the 'f' option to override the read-only status of the destination folder. A status of 1 and an empty message and messageId confirm the copy was successful.

[status,message,messageId] = copyfile('myfile1.m', 'restricted', 'f');
status
message
messageId
status =

  logical

   1


message =

  0x0 empty char array


messageId =

  0x0 empty char array

Input Arguments

collapse all

File or folder to copy, specified as a character vector. source can be an absolute or relative path. To copy multiple files or folders, use wildcards (*).

File or folder destination, specified as a character vector. destination can be an absolute or relative path, but cannot include wildcards.

Output Arguments

collapse all

Copy status, indicating if the attempt to move the file or folder is successful, returned as 0 or 1. If the attempt is successful, the value of status is 1. Otherwise, the value is 0.

Data Types: logical

Error message, returned as a character vector. If an error or warning occurs, msg contains the message text of the error or warning. Otherwise, msg is empty, ''.

Error message identifier, returned as a character vector. If an error or warning occurs, msgID contains the message identifier of the error or warning. Otherwise, msgID is empty, ''.

Introduced before R2006a

Was this topic helpful?