Folder::Move
이 폴더로부터 지정한 엔트리를 다른 폴더로 이동시킵니다.
virtual GSErrCode Move (
const Name& from,
Folder& target,
const Name& to,
DataSafety safety = Normal
);
파라미터
- from
- (이 폴더의) 이동시킬 엔트리의 이름입니다.
- target
- 이동 동작의 목적지 폴더입니다.
- to
- 목적지 폴더의 이동될 엔트리의 새로운 이름입니다.
- safety
- 동작 범위를 제어하는 데이터 보안 레벨입니다.
리턴 값
| 값 | 의미 |
|---|---|
| NoError* | OK |
| SourceNotFound* | 이동시킬 소스 엔트리를 발견하지 못했습니다. |
| TargetExists* | 새로운 이름을 가진 엔트리가 이미 목적지 폴더에 존재합니다. |
| DeviceIsFull* | 디바이스가 가득 찼습니다. |
| AccessDenied* | 이 동작을 폴더 혹은 엔트리에서 허용하지 않습니다. |
| Error* | 불특정 오류입니다. |
* Folder class 범위에서 선언함
* GS 네임스페이스에서 선언했지만, 글로벌 범위에서 접근 가능함
설명
이 메소드는 이 폴더에 있는 이름 from을 가진 파일 시스템 엔트리(파일, 폴더, 링크)를 target으로 지정한 목적지 폴더의 새로운 이름 to로 이동(재배치)시킵니다. 이름 from과 to는 같을 수 있습니다. 이 폴더와 target 폴더 역시 같을 수 있습니다. (Rename 동작을 보여줌) Move 동작은 (내부 내용들과 함께) 전체 엔트리에 적용됩니다. 이것은 이동 동작이 본질적으로 재귀적이라는 것을 의미합니다.
만약 목적지 폴더가 이름 to를 가진 엔트리(파일, 폴더, 링크)를 이미 가지고 있으며, 폴더들 중 하나가 기록할 수 없다면 Move는 실패합니다. 만약 이동 동작 도중 실패하게 되면, 원래 파일 시스템 상태를 복원하려고 시도하게 됩니다.
IgnoreWriteProtection 값을 safety 파라미터에 전달하지 않는다면, 쓰기-보호된 엔트리 (Windows의 경우 읽기-전용 엔트리, Macintosh의 경우 잠긴 엔트리) 상에서 Move는 실패합니다.
Windows 참고:
- 이 메소드는 루트 폴더에서 실패합니다. (왜냐하면 가상이며 기록할 수 없기 때문입니다)
- 만약 소스와 목적지 볼륨이 다르다면, 복사 및 제거 동작으로 이동을 수행합니다.
Macintosh 참고:
- 이 메소드는 루트 폴더에서 실패합니다. (왜냐하면 가상이며 기록할 수 없기 때문입니다) 단, 이 폴더와 target 폴더 모두 루트 폴더일 때에는 예외입니다. 그래서 볼륨의 이름을 변경하는 것이 가능합니다.
- 만약 소스와 목적지 볼륨이 다르거나 목적지 폴더 안에 이름 from을 가진 엔트리가 있다면, 복사 및 제거 동작으로 이동을 수행합니다.
- 리소스 포크(fork)와 데이터 포크(fork) 모두 이동됩니다.
