copyfile

파일 또는 폴더 복사

구문

copyfile source

copyfile source destination

copyfile source destination f

copyfile(source,destination,CopyLinkBehavior=slbehavior)

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에 대한 읽기/쓰기 특성의 상태는 변경되지 않습니다.

copyfile(source,destination,CopyLinkBehavior=slbehavior)는 기호화된 링크를 복사할지 아니면 이 링크의 대상을 복사할지 여부를 지정합니다. (R2024b 이후)

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 =

  0×0 empty char array

messageId

messageId =

  0×0 empty char array

입력 인수

source — 복사할 파일 또는 폴더

string형 스칼라 | 문자형 벡터

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

로컬 파일 또는 폴더를 복사할 때 source는 절대 경로이거나 상대 경로일 수 있습니다. 그러나 원격 위치의 파일과 폴더의 경우 전체 경로를 URL(Uniform Resource Locator)로 지정해야 합니다. 인터넷 URL에는 프로토콜 유형 "http://" 또는 "https://"가 포함되어야 합니다. 자세한 내용은 원격 데이터로 작업하기 항목을 참조하십시오.

참고

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

destination — 대상 파일 또는 폴더

string형 스칼라 | 문자형 벡터

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

destination이 로컬 위치인 경우 절대 경로 또는 상대 경로를 지정할 수 있습니다. source가 폴더이고 destination 폴더가 존재하지 않을 경우, copyfile이 그 폴더를 만듭니다. source가 파일이고 destination 폴더가 존재하지 않을 경우, copyfile이 그 폴더 이름을 사용하여 파일을 생성합니다(확장자 없음). 대상 폴더에 파일을 쓰려면 사전에 대상 폴더가 존재해야 합니다.

destination이 원격 위치인 경우 URL의 전체 경로를 지정해야 합니다. 자세한 내용은 원격 데이터로 작업하기 항목을 참조하십시오.

참고

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

slbehavior — 기호화된 링크 동작

"osdefault" (디폴트 값) | "preserve" | "resolve"

R2024b 이후

기호화된 링크 동작으로, 다음 값 중 하나로 지정됩니다.

• "osdefault" – 파일 시스템의 디폴트 동작을 사용합니다.

• "preserve" – 기호화된 링크를 복사하고 대상에서 기호화된 링크로 유지합니다. 기호화된 링크의 대상이 동일하게 유지됩니다.

• "resolve" – 기호화된 링크의 대상을 복사합니다.

출력 인수

status — 복사 상태

0 | 1

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

데이터형: logical

msg — 오류 메시지

문자형 벡터

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

msgID — 오류 메시지 ID

문자형 벡터

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

제한 사항

• MATLAB^®은 인증을 요하는 인터넷 URL을 지원하지 않습니다.

• MATLAB Online™은 Microsoft^® OneDrive™ 파일 및 폴더와 연결된 인터넷 URL을 지원합니다. 반면 설치된 MATLAB에서는 로컬 OneDrive 파일만 지원합니다.

팁

• 이 함수는 Microsoft Windows^® 바로 가기 파일(.lnk)을 지원합니다.

확장 기능

C/C++ 코드 생성

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

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

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

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

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

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

버전 내역

R2006a 이전에 개발됨

R2024b: 파일 작업 함수를 사용하여 HTTP 및 HTTPS를 통해 데이터 읽기

인터넷 URL을 통해 파일 읽기 작업을 수행하여 주요 온라인 소스에서 데이터를 읽을 수 있습니다.

R2024b: 기호화된 링크를 사용하여 파일과 폴더 조작

기호화된 링크로 파일과 폴더를 복사할 수 있습니다. 기호화된 링크를 소스로 지정하면 기호화된 링크 자체를 복사할지 아니면 이 링크의 대상을 복사할지 여부를 제어할 수 있습니다.

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

도움말 항목

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