File::SetPosition
파일 내용 위치를 세트합니다.
virtual GSErrCode SetPosition (
UInt64 result );
파라미터
- result
- 새로운 파일 내용 위치입니다. 위치의 단위는 문자(바이트)입니다.
리턴 값
| 값 | 의미 |
|---|---|
| NoError* | OK |
| IllegalPosition* | 잘못된 파일 내용 위치를 지정했습니다. |
| GS::OChannel::OutputIsFull | 출력 디바이스가 가득 찼습니다. |
| GS::OChannel::WriteError | 출력 디바이스 상에서 쓰기 오류입니다. |
| Error* | 불특정 오류입니다. |
* File class 범위에서 선언함
* GS 네임스페이스에서 선언했지만, 글로벌 범위에서 접근 가능함
설명
이 메소드는 파일 내용 위치를 result 값으로 세트합니다.
파일 내용 끝 이후의 위치로 세트하는 것은 허용하지 않습니다. 그러나 파일 내용의 끝으로 세트하는 것은 가능합니다.
위치 설정은 출력 버퍼들이 flush될 수 있음을 의미하기 때문에 쓰기 오류가 발생할 수도 있습니다.
이 메소드는 Seek (IO::File::Start, offset);와 동등하다는 것을 참고하십시오.
만약 파일 내용이 열려 있지 않거나 appending 모드로 열려 있다면, 이 동작은 허용하지 않습니다.
또한 출력 채널 (GS::OChannel) 블록 동작들 "내부"에서도 허용하지 않습니다.
(즉, 마크를 배치했을 때, 또는 오프셋을 리셋하지 않았을 때)
