copyfile

파일 또는 폴더 복사

구문

copyfile source

copyfile source destination

copyfile source destination f

status = copyfile(___)

[status,msg] = copyfile(___)

[status,msg,msgID] = copyfile(___)

설명

copyfile source는 파일 또는 폴더 source를 현재 폴더에 복사합니다. copyfile 작업이 성공한 후 새 파일에 대한 타임스탬프는 source에 대한 타임스탬프와 동일합니다.

copyfile source destination은 source를 파일 또는 폴더 destination에 복사합니다.

• source가 파일이면 destination은 파일 또는 폴더일 수 있습니다.

• source가 폴더이면 destination은 폴더여야 합니다.

• source가 폴더이거나, 여러 파일을 지정하는데 destination이 존재하지 않으면 copyfile은 destination을 만들려고 시도합니다.

copyfile source destination f는 destination이 쓰기 불가능(not writable)일 때에도 source를 destination으로 복사합니다. destination에 대한 읽기/쓰기 특성의 상태는 변경되지 않습니다.

status = copyfile(___)은 지정된 파일 또는 폴더를 복사하고, 작업이 성공한 경우 상태 1을 반환합니다. 그렇지 않으면 copyfile은 0을 반환합니다. 이 구문은 이전 구문의 모든 입력 인수 조합과 함께 사용할 수 있습니다.

[status,msg] = copyfile(___)은 발생하는 모든 경고 또는 오류에 대한 메시지 텍스트도 반환합니다.

[status,msg,msgID] = copyfile(___)은 발생하는 모든 경고 또는 오류에 대한 메시지 ID도 반환합니다.

예제

파일을 다른 폴더로 복사

현재 폴더의 myfile1.m을 하위 폴더 myFolder로 복사합니다.

mkdir myFolder
copyfile myfile1.m myFolder

현재 폴더에 있는 파일의 복사본 만들기

현재 폴더에 있는 myfile1.m의 복사본을 만들고 이름 myfile2.m을 할당합니다.

copyfile myfile1.m myfile2.m

파일과 폴더를 새 폴더로 복사하기

이름이 my로 시작하는 파일과 하위 폴더를 현재 폴더에서 폴더 newFolder로 복사합니다. newFolder는 존재하지 않는 폴더입니다.

copyfile my* newFolder

파일을 읽기 전용 폴더로 복사하기

파일 myfile1.m을 현재 폴더에서 읽기 전용 폴더 restricted로 복사합니다.

읽기 전용 폴더 restricted를 만듭니다.

mkdir restricted
fileattrib restricted -w

파일 myfile1.m을 복사하고 이름을 바꿉니다. 상태 0은 복사가 실패했음을 나타냅니다.

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

status = logical
   0

'f' 옵션을 사용하여 파일 myfile1.m을 복사하면 대상 폴더의 읽기 전용 상태를 재지정할 수 있습니다. 상태가 1이고 message 및 messageId가 비어 있으면 복사가 성공한 것입니다.

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

status = logical
   1

message

message =

  0x0 empty char array

messageId

messageId =

  0x0 empty char array

입력 인수

source — 복사할 파일 또는 폴더

문자형 벡터 | string형 스칼라

복사할 파일 또는 폴더로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 파일이나 폴더를 여러 개 복사하려면 와일드카드(*)를 사용하십시오.

로컬 파일 또는 폴더를 복사할 때 source는 절대 경로이거나 상대 경로일 수 있습니다. 그러나 원격 위치의 파일과 폴더를 복사하려면 source는 URL(Uniform Resource Locator)로 지정된 전체 경로를 포함해야 합니다. 자세한 내용은 원격 데이터로 작업하기 항목을 참조하십시오.

참고

source가 string형이면 모든 입력값을 괄호로 묶으십시오. 예를 들면 copyfile("myfile.m","newfolder")와 같습니다.

destination — 대상 파일 또는 폴더

문자형 벡터 | string형 스칼라

대상 파일 또는 폴더로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. destination은 와일드카드(*)를 포함할 수 없습니다.

destination이 로컬 위치인 경우 절대 경로 또는 상대 경로로 지정될 수 있습니다. destination에 지정된 폴더가 존재하지 않으면 copyfile은 폴더를 만듭니다. destination이 원격 위치인 경우 URL로 지정된 전체 경로를 포함해야 합니다. 자세한 내용은 원격 데이터로 작업하기 항목을 참조하십시오.

참고

destination이 string형이면 모든 입력값을 괄호로 묶으십시오. 예를 들면 copyfile("myfile.m","newfolder")와 같습니다.

출력 인수

status — 복사 상태

0 | 1

파일 또는 폴더 이동 시도의 성공 여부를 나타내는 복사 상태로, 0 또는 1로 반환됩니다. 이 시도에 성공할 경우 status의 값은 1입니다. 그렇지 않을 경우 값은 0입니다.

데이터형: logical

msg — 오류 메시지

문자형 벡터

오류 메시지로, 문자형 벡터로 반환됩니다. 오류 또는 경고가 발생하는 경우 msg에는 해당 오류 또는 경고의 메시지 텍스트가 들어 있습니다. 그렇지 않은 경우 msg는 비어 있습니다('').

msgID — 오류 메시지 ID

문자형 벡터

오류 메시지 ID로, 문자형 벡터로 반환됩니다. 오류 또는 경고가 발생하는 경우 msgID에는 해당 오류 또는 경고의 메시지 ID가 들어 있습니다. 그렇지 않은 경우 msgID는 비어 있습니다('').

확장 기능

C/C++ 코드 생성

MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• copyfile 함수는 와일드카드 연산 또는 URL을 입력값으로 지원하지 않습니다.

• MATLAB^®에서 생성된 코드는 MATLAB 내에서 실행되는 것과 다르게 동작할 수 있습니다.

  이러한 경우 생성된 코드의 파일 처리는 Windows^® 플랫폼에서의 C 언어 CopyFileExA 함수 또는 UNIX^® 시스템에서의 C 언어 read 함수 및 write 함수와 유사합니다.

스레드 기반 환경
MATLAB®의 backgroundPool을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool을 사용해 코드 실행 속도를 높일 수 있습니다.

버전 내역

R2006a 이전에 개발됨

R2020a: UNIX 플랫폼에서 와일드카드 표현식 *.*를 사용하면 확장자가 있는 파일만 검색함

R2020a부터 UNIX 플랫폼에서 와일드카드 표현식 *.*는 더 이상 확장자가 없는 폴더 또는 파일을 검색하지 않습니다. 이전 릴리스에서는 확장자가 없는 파일을 포함하여 확장자에 관계없이 폴더 또는 파일을 검색합니다. Microsoft^® Windows 플랫폼에는 이러한 동작 변경 사항이 적용되지 않습니다.

R2020a: 기호화된 링크는 여러 플랫폼과 파일 시스템에서 일관되게 처리됨

기호화된 링크(또는 symlink)는 대상 파일 또는 폴더를 가리키는 파일 시스템 객체입니다. R2020a부터, copyfile 함수가 symlink 파일 또는 폴더에 대해 작동할 때 그 동작이 변경됩니다.

• 복사 결과가 플랫폼에 독립적임: copyfile은 이제 여러 운영 체제에서 symlink를 동일한 방식으로 처리합니다. 예를 들어, 파일 myFile.m과 myFile.m을 가리키는 symlink symlinkToMyFile을 갖는 폴더 구조가 있다고 가정하겠습니다.

  myFile.m
  symlinkToMyFile
  

  R2020a부터 copyfile('symlinkToMyFile','newFile')은 symlink의 타깃(즉, myFile.m)을 대상에 복사합니다. 이전 릴리스에서는, Linux^®에서 copyfile이 대신 symlink를 복사했습니다.

  플랫폼	newFile(R2020a 릴리스부터)	newFile(R2019b 이하 릴리스)
  Linux	myFile.m	symlinkToMyFile
  Mac	myFile.m	myFile.m
  Windows	myFile.m	myFile.m

• copyfile이 소스 폴더의 내용만 복사함: 비어 있지 않은 폴더를 symlink 폴더에 복사할 때, copyfile은 이제 전체 소스 폴더가 아니라 소스 폴더의 내용(즉, 소스 폴더 내의 파일과 폴더)을 복사합니다. 마찬가지로, symlink 폴더를 대상 폴더로 복사할 때 symlink 폴더의 내용만 복사됩니다.

  예를 들어, Linux에 비어 있지 않은 폴더 myFolder와 이 폴더에 대한 symlink symlinkToMyFolder로 구성된 폴더 구조가 있다고 가정하겠습니다. 다음 표에서는 여러 MATLAB 릴리스에서 copyfile('myFolder','simlinkToMyFolder')를 실행한 후의 폴더 구조를 보여줍니다.

  복사 전 폴더 구조	복사 후 폴더 구조(R2020a 릴리스부터)	복사 후 폴더 구조(R2019b 이하 릴리스)
  myFolder myFile.m symlinkToMyFolder	myFolder myFile.m symlinkToMyFolder myFile.m	myFolder myFile.m symlinkToMyFolder myFolder myFile.m

참고 항목

cd | delete | dir | mkdir | movefile | rmdir

도움말 항목

• 파일과 폴더 관리하기
• 파일 이름 지정하기
• 원격 데이터로 작업하기