.\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek and the American National Standards Committee X3, .\" on Information Processing Systems. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" @(#) fseek. 3 8.1 (Berkeley) 6/4/93 .\" %FreeBSD: src/lib/libc/stdio/fseek. 3, v 1.5. 2.7 2001/12/14 18:33:57 ru Exp % .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/fseek. 3, v 1.4 2002/05/18 07:12:54 horikawa Exp $ .\" .Dd March 5, 1999 .Dt FSEEK 3 .Os .Sh 명칭 .Nm fgetpos , .Nm fseek , .Nm fseeko , .Nm fsetpos , .Nm ftell , .Nm ftello , .Nm rewind .Nd 스트림의 위치 변경 .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In stdio.h .Ft int .Fn fseek "FILE *stream" "long offset" "int whence" .Ft long .Fn ftell "FILE *stream" .Ft void .Fn rewind "FILE *stream" .Ft int .Fn fgetpos "FILE *stream" "fpos_t *pos" .Ft int .Fn fsetpos "FILE *stream" "const fpos_t *pos" .In sys/types.h .Ft int .Fn fseeko "FILE *stream" "off_t offset" "int whence" .Ft off_t .Fn ftello "FILE *stream" .Sh 해설 .Fn fseek 함수는, .Fa stream 하지만 가리키는 스트림의 파일 위치 인디케이터(indicator)를 설정합니다. 새로운 위치는 바이트 단위로 계측 되어 .Fa whence 그리고 지정된 위치에 .Fa offset 바이트를 더하는 것으로 얻을 수 있습니다. .Fa whence 하지만 .Dv SEEK_SET , .Dv SEEK_CUR , .Dv SEEK_END (으)로 설정되어 있는 경우, 오프셋(offset)는, 각각, 파일의 최초, 인디케이터(indicator)의 현재 위치, 파일의 최후로부터의 상대 위치가 됩니다. .Fn fseek 함수의 호출로 문제가 발생하지 않는 경우는, 스트림의 end-of-file 지시자가 클리어 되어 그 스트림에 대한다 .Xr ungetc 3 함수의 효과는 삭제됩니다. .Pp .Fn ftell 함수는, .Fa stream 하지만 가리키는 스트림의 파일 위치 인디케이터(indicator)의 현재의 값을 입수합니다. .Pp .Fn rewind 함수는, .Fa stream 하지만 가리키는 스트림의 파일 위치 인디케이터(indicator)를 파일의 최초로 설정합니다. 이것은, 스트림의 에러 인디케이터(indicator)가 클리어 되는 것 ( .Xr clearerr 3 (을)를 참조)를 제외하면, 이하와 같은 결과가 됩니다. .Pp .Dl (void) fseek(stream, 0L, SEEK_SET) .Pp .Fn fseeko 함수는 .Fn fseek (와)과 같습니다만, 인수에는 .Fa long 대신에 .Fa off_t (을)를 취합니다. (와)과 같이 .Fn ftello 함수는 .Fn ftell (와)과 같습니다만, .Fa off_t (을)를 돌려줍니다. .Pp .Fn fgetpos 함수와 .Fn fsetpos 함수는, ( whence 를 .Dv SEEK_SET (으)로 설정했다 ) .Fn ftell (이)나 .Fn fseek (와)과 같은 인터페이스로, 파일 오프셋(offset)의 현재의 값을 .Fa pos 하지만 참조하는 오브젝트로부터 설정하거나 .Fa pos 하지만 참조하는 오브젝트에 보존하거나 합니다. 일부의 .Pq Tn UNIX 이외의 시스템에서는, .Dq Fa fpos_t 오브젝트가 복합 오브젝트일지도 모르기 때문에, 이식성을 유지하면서 텍스트 스트림의 위치를 변경하기 위해서는, 이 routine에 의밖에 없는 것도 있습니다. .Sh 반환값 .Fn rewind 함수는 값을 돌려주지 않습니다. .Pp .Rv -std fgetpos fseek fseeko fsetpos .Pp 성공해 종료하면(자), .Fn ftell 및 .Fn ftello (은)는 현재의 오프셋(offset)를 돌려줍니다. 그 이외의 경우는 \-1 이 돌려주어 글로벌 변수 .Va errno 하지만 설정되어 에러를 나타냅니다. .Sh 에러 .Bl -tag -width Er .It Bq Er EBADF 지정되었다 .Fa stream 하지만, 시크 할 수 있는 스트림이 아닙니다. .It Bq Er EINVAL .Fn fseek 의 .Fa whence 인수가, .Dv SEEK_SET , .Dv SEEK_END , .Dv SEEK_CUR 의 어떤 것이기도 하지 않습니다. .It Bq Er EOVERFLOW .Fn ftell (을)를 실행한 결과의 파일의 오프셋(offset)가 long 형의 오브젝트에서는 올바르게 표현할 수 없는 값이 되었습니다. .El .Pp .Fn fgetpos , .Fn fseek , .Fn fseeko , .Fn fsetpos , .Fn ftell , .Fn ftello 함수가 실패했을 때에는, routine .Xr fflush 3 , .Xr fstat 2 , .Xr lseek 2 , .Xr malloc 3 에 붙어 가리키고 있는 에러가 .Va errno (으)로 설정되어 있는 일도 있습니다. .Sh 관련 항목 .Xr lseek 2 .Sh 표준 .Fn fgetpos , .Fn fsetpos , .Fn fseek , .Fn ftell , .Fn rewind 함수는, .St -isoC 에 적합하고 있습니다. .Pp .Fn fseeko (와)과 .Fn ftello 함수는, .St -susv2 에 적합하고 있습니다. .\"X kuma 1999-11-6