File::SetDataLength
파일 내용의 길이를 세트합니다.
virtual GSErrCode SetDataLength (
USize newLength );
파라미터
- newLength
- 새로운 파일 내용 길이입니다. 길이의 단위는 문자(바이트)입니다.
리턴 값
| 값 | 의미 |
|---|---|
| NoError* | OK |
| AccessDenied* | 이 동작을 이 파일에서 허용하지 않습니다. |
| GS::OChannel::OutputIsFull | 출력 디바이스가 가득 찼습니다. |
| GS::OChannel::WriteError | 출력 디바이스에서 쓰기 오류입니다. |
| Error* | 불특정 오류입니다. |
* File class 범위에서 선언함
* GS 네임스페이스에서 선언했지만, 글로벌 범위에서 접근 가능함
설명
이 메소드는 파일 내용의 길이를 newLength로 결정된 값으로 세트합니다.
결과적으로 파일 내용은 잘리거나 확장될 수도 있습니다.
만약 확장된다면, 추가된 부분의 내용은 정의되지 않습니다.
만약 파일이 쓰기 모드의 일종으로 이미 열려 있다면, 파일 내용 위치는 파일 내용의 새로운 끝으로 세트될 것입니다.
이 경우 내부 버퍼들이 먼저 flush되므로 쓰기 오류가 발생할 수도 있습니다.
만약 파일이 이미 읽기 전용 모드로 열려 있다면 이 동작은 허용하지 않습니다. 왜냐하면 이 동작은 파일 내용 상에서 쓰기와 유사한 행동을 하기 때문입니다.
