.\" Japanese Version Copyright (c) 1998 NAKANO Takeo all rights reserved.
.\" Translated Mon Apr 27 1998 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\"
-.\" WORD: file position indicator ¥Õ¥¡¥¤¥ë°ÌÃÖɽ¼¨»Ò
-.\" WORD: error indicator ¥¨¥é¡¼É½¼¨»Ò
+.\" WORD: file position indicator ファイル位置表示子
+.\" WORD: error indicator エラー表示子
.\"
.TH FSEEK 3 1993-11-29 "GNU" "Linux Programmer's Manual"
-.SH ̾Á°
-fgetpos, fseek, fsetpos, ftell, rewind \- ¥¹¥È¥ê¡¼¥à¤Î°ÌÃÖ¤òÊѹ¹¤¹¤ë
-.SH ½ñ¼°
+.SH 名前
+fgetpos, fseek, fsetpos, ftell, rewind \- ストリームの位置を変更する
+.SH 書式
.B #include <stdio.h>
.sp
.BI "int fseek(FILE *" stream ", long " offset ", int " whence );
.BI "int fgetpos(FILE *" stream ", fpos_t *" pos );
.br
.BI "int fsetpos(FILE *" stream ", fpos_t *" pos );
-.SH ÀâÌÀ
+.SH 説明
.BR fseek ()
-´Ø¿ô¤Ï
+関数は
.I stream
-¤Ë¤è¤Ã¤Æ»ØÄꤵ¤ì¤¿¥¹¥È¥ê¡¼¥à¤Ë¤ª¤¤¤Æ¡¢¥Õ¥¡¥¤¥ë°ÌÃÖɽ¼¨»Ò
-(file position indicator) ¤ò¥»¥Ã¥È¤¹¤ë¡£¿·¤¿¤Ê°ÌÃÖ (¥Ð¥¤¥Èñ°Ì)
-¤Ï
+によって指定されたストリームにおいて、ファイル位置表示子
+(file position indicator) をセットする。新たな位置 (バイト単位)
+は
.I whence
-¤Ç»ØÄꤵ¤ì¤¿°ÌÃÖ¤Ë
+で指定された位置に
.I offset
-¥Ð¥¤¥È¤ò²Ã¤¨¤ë¤³¤È¤Ë¤è¤Ã¤ÆÍ¿¤¨¤é¤ì¤ë¡£
+バイトを加えることによって与えられる。
.I whence
-¤¬
+が
.BR SEEK_SET ,
.BR SEEK_CUR ,
.B SEEK_END
-¤Î¤É¤ì¤«¤Ë¤Ê¤Ã¤Æ¤¤¤ë¾ì¹ç¤Ï¡¢¤½¤ì¤¾¤ì¥Õ¥¡¥¤¥ë¤ÎÀèƬ¡¢¸½ºß¤Î°ÌÃÖɽ¼¨»Ò¡¢
-¥Õ¥¡¥¤¥ë¤ÎËöÈø¤«¤é¤Î¥ª¥Õ¥»¥Ã¥È¤¬¼è¤é¤ì¤ë¡£
+のどれかになっている場合は、それぞれファイルの先頭、現在の位置表示子、
+ファイルの末尾からのオフセットが取られる。
.BR fseek ()
-´Ø¿ô¤Î¸Æ¤Ó½Ð¤·¤¬À®¸ù¤¹¤ë¤È¡¢¥¹¥È¥ê¡¼¥à¤Î end-of-file ɽ¼¨»Ò¤Ï
-¥¯¥ê¥¢¤µ¤ì¡¢¤½¤ì¤Þ¤Ç¤Ë
+関数の呼び出しが成功すると、ストリームの end-of-file 表示子は
+クリアされ、それまでに
.BR ungetc (3)
-´Ø¿ô¤ÇÌᤷ¤¿¥Ç¡¼¥¿¤Ï¤Ê¤«¤Ã¤¿¤³¤È¤Ë¤Ê¤ë¡£
+関数で戻したデータはなかったことになる。
.PP
.BR ftell ()
-´Ø¿ô¤Ï
+関数は
.I stream
-¤Ë¤è¤Ã¤Æ»ØÄꤵ¤ì¤¿¥¹¥È¥ê¡¼¥à¤Ë¤ª¤±¤ë¡¢¥Õ¥¡¥¤¥ë°ÌÃÖɽ¼¨»Ò
-¤Î¸½»þÅÀ¤Ç¤ÎÃͤòÍ¿¤¨¤ë¡£
+によって指定されたストリームにおける、ファイル位置表示子
+の現時点での値を与える。
.PP
.BR rewind ()
-´Ø¿ô¤Ï
+関数は
.I stream
-¤Ë¤è¤Ã¤Æ»ØÄꤵ¤ì¤¿¥¹¥È¥ê¡¼¥à¤Ë¤ª¤¤¤Æ¡¢¥Õ¥¡¥¤¥ë°ÌÃÖɽ¼¨»Ò
-¤ò¥Õ¥¡¥¤¥ë¤ÎÀèƬ¤Ë¥»¥Ã¥È¤¹¤ë¡£¤³¤Î´Ø¿ô¤Ï°Ê²¼¤ÈÅù²Á¤Ç¤¢¤ë¡£
+によって指定されたストリームにおいて、ファイル位置表示子
+をファイルの先頭にセットする。この関数は以下と等価である。
.PP
.RS
(void) fseek(stream, 0L, SEEK_SET)
.RE
.PP
-¤¿¤À¤·
+ただし
.BR rewind ()
-¤Ç¤Ï¥¹¥È¥ê¡¼¥à¤ËÂФ¹¤ë¥¨¥é¡¼É½¼¨»Ò (error indicator) ¤âƱ»þ¤Ë
-¥¯¥ê¥¢¤µ¤ì¤ë (
+ではストリームに対するエラー表示子 (error indicator) も同時に
+クリアされる (
.BR clearerr (3)
-¤ò¸«¤è)¡£
+を見よ)。
.PP
.BR fgetpos ()
-´Ø¿ô¤È
+関数と
.BR fsetpos ()
-´Ø¿ô¤Ï¡¢¤½¤ì¤¾¤ì
+関数は、それぞれ
.BR ftell ()
-¤È
+と
.BR fseek ()
-¤Ç
+で
.I whence
-¤Ë
+に
.B SEEK_SET
-¤ò»ØÄꤷ¤¿¾ì¹ç¤ÈƱÍͤε¡Ç½¤ò¡¢°Û¤Ê¤ë¥¤¥ó¥¿¡¼¥Õ¥§¡¼¥¹¤ÇÄ󶡤¹¤ë¡£
+を指定した場合と同様の機能を、異なるインターフェースで提供する。
.BR fgetpos ()
-¤Ï¥Õ¥¡¥¤¥ë¥ª¥Õ¥»¥Ã¥È¤Î¸½ºß¤ÎÃͤò
+はファイルオフセットの現在の値を
.I pos
-¤¬»²¾È¤¹¤ë¥ª¥Ö¥¸¥§¥¯¥È¤ËÊݸ¤·¡¢
+が参照するオブジェクトに保存し、
.BR fsetpos ()
-¤Ï¥Õ¥¡¥¤¥ë¥ª¥Õ¥»¥Ã¥È¤ò
+はファイルオフセットを
.I pos
-¤ËÀßÄꤹ¤ë¡£
-UNIX °Ê³°¤Î¥·¥¹¥Æ¥à¤Ë¤ª¤¤¤Æ¤Ï¡¢
+に設定する。
+UNIX 以外のシステムにおいては、
.I fpos_t
-¤¬¹½Â¤ÂΤʤɤÎÊ£»¨¤Ê¥ª¥Ö¥¸¥§¥¯¥È¤Ë¤Ê¤Ã¤Æ¤¤¤Æ¡¢¤³¤ì¤é¤Î¥ë¡¼¥Á¥ó¤¬¥Æ¥¥¹
-¥È¥¹¥È¥ê¡¼¥à¤Ç¥Õ¥¡¥¤¥ë°ÌÃÖ¤òÊѹ¹¤¹¤ëÊýË¡¤Î¤¦¤Á¡¢°Ü¿¢À¤Î¤¢¤ëÍ£°ì¤Î¤â¤Î
-¤Ë¤Ê¤Ã¤Æ¤¤¤ë¾ì¹ç¤â¤¢¤ë¡£
-.SH ÊÖ¤êÃÍ
+ã\81\8cæ§\8bé\80 ä½\93ã\81ªã\81©ã\81®è¤\87é\9b\91ã\81ªã\82ªã\83\96ã\82¸ã\82§ã\82¯ã\83\88ã\81«ã\81ªã\81£ã\81¦ã\81\84ã\81¦ã\80\81ã\81\93ã\82\8cã\82\89ã\81®ã\83«ã\83¼ã\83\81ã\83³ã\81\8cã\83\86ã\82ã\82¹
+トストリームでファイル位置を変更する方法のうち、移植性のある唯一のもの
+になっている場合もある。
+.SH 返り値
.BR rewind ()
-¤ÏÊÖ¤êÃͤò»ý¤¿¤Ê¤¤¡£
+は返り値を持たない。
.BR fgetpos (),
.BR fseek (),
.BR fsetpos ()
-¤ÏÀ®¸ù¤¹¤ë¤È 0 ¤òÊÖ¤¹¡£
+は成功すると 0 を返す。
.BR ftell ()
-¤Ï¸½ºß¤Î¥ª¥Õ¥»¥Ã¥È¤òÊÖ¤¹¡£¼ºÇÔ¤·¤¿¾ì¹ç¤ÏÊÖ¤êÃÍ¤Ï \-1 ¤È¤Ê¤ê¡¢
+は現在のオフセットを返す。失敗した場合は返り値は \-1 となり、
.I errno
-¤Ë¥¨¥é¡¼¤ò¼¨¤¹Ãͤ¬¥»¥Ã¥È¤µ¤ì¤ë¡£
-.SH ¥¨¥é¡¼
+にエラーを示す値がセットされる。
+.SH ã\82¨ã\83©ã\83¼
.TP
.B EBADF
-»ØÄꤷ¤¿
+指定した
.I stream
-¤¬¥·¡¼¥¯¤Ç¤¤Ê¤¤¡£
+がシークできない。
.TP
.B EINVAL
.BR fseek ()
-´Ø¿ô¤ËÂФ·¤ÆÍ¿¤¨¤¿
+関数に対して与えた
.I whence
-°ú¿ô¤¬
+引数が
.BR SEEK_SET ,
.BR SEEK_END ,
.B SEEK_CUR
-°Ê³°¤ÎÃͤǤ¢¤Ã¤¿¡£
+以外の値であった。
.PP
.BR fgetpos (),
.BR fseek (),
.BR fsetpos (),
.BR ftell ()
-¤Ï¡¢¤½¤ì¤¾¤ì
+は、それぞれ
.BR fflush (3),
.BR fstat (2),
.BR lseek (2),
.BR malloc (3)
-¤Ê¤É¤Î¥ë¡¼¥Á¥ó¤ò¸Æ¤Ó½Ð¤¹ºÝ¤Ë¼ºÇÔ¤¹¤ë²ÄǽÀ¤¬¤¢¤ë¡£¤³¤Î¾ì¹ç¤Ï
-¤½¤ì¤¾¤ìÂбþ¤·¤¿
+などのルーチンを呼び出す際に失敗する可能性がある。この場合は
+それぞれ対応した
.I errno
-¤¬ÀßÄꤵ¤ì¤ë¡£
-.SH ½àµò
+が設定される。
+.SH 準拠
C89, C99.
-.SH ´ØÏ¢¹àÌÜ
+.SH 関連項目
.BR lseek (2),
.BR fseeko (3)