OSDN Git Service

1f508f394355caa378d211c4e69d18bff0cdeb87
[linuxjm/LDP_man-pages.git] / draft / man3 / fseeko.3
1 .\" Copyright 2001 Andries Brouwer <aeb@cwi.nl>.
2 .\"
3 .\" Permission is granted to make and distribute verbatim copies of this
4 .\" manual provided the copyright notice and this permission notice are
5 .\" preserved on all copies.
6 .\"
7 .\" Permission is granted to copy and distribute modified versions of this
8 .\" manual under the conditions for verbatim copying, provided that the
9 .\" entire resulting derived work is distributed under the terms of a
10 .\" permission notice identical to this one.
11 .\"
12 .\" Since the Linux kernel and libraries are constantly changing, this
13 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
14 .\" responsibility for errors or omissions, or for damages resulting from
15 .\" the use of the information contained herein.  The author(s) may not
16 .\" have taken the same level of care in the production of this manual,
17 .\" which is licensed free of charge, as they might when working
18 .\" professionally.
19 .\"
20 .\" Formatted or processed versions of this manual, if unaccompanied by
21 .\" the source, must acknowledge the copyright and authors of this work.
22 .\"
23 .\" Japanese Version Copyright (c) 2002 NAKANO Takeo all rights reserved.
24 .\" Translated 2002-01-06, NAKANO Takeo <nakano@apm.seikei.ac.jp>
25 .\" Updated 2006-01-18, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
26 .\"
27 .TH FSEEKO 3  2001-11-05 "" "Linux Programmer's Manual"
28 .\"O .SH NAME
29 .\"O fseeko, ftello \- seek to or report file position
30 .SH 名前
31 fseeko, ftello \- ファイル位置を探す/報告する
32 .\"O .SH SYNOPSIS
33 .SH 書式
34 .nf
35 .B #include <stdio.h>
36 .sp
37 .BI "int fseeko(FILE *" stream ", off_t " offset ", int " whence );
38 .sp
39 .BI "off_t ftello(FILE *" stream );
40 .BI
41 .fi
42 .\"O .SH DESCRIPTION
43 .SH 説明
44 .\"O The
45 .\"O .BR fseeko ()
46 .\"O and
47 .\"O .BR ftello ()
48 .\"O functions are identical to
49 .\"O .BR fseek (3)
50 .\"O and
51 .\"O .BR ftell (3)
52 .\"O (see
53 .\"O .BR fseek (3)),
54 .\"O respectively, except that the \fIoffset\fP argument of
55 .\"O .BR fseeko ()
56 .\"O and the return value of
57 .\"O .BR ftello ()
58 .\"O is of type \fIoff_t\fP
59 .\"O instead of \fIlong\fP.
60 .BR fseeko ()
61 関数および
62 .BR ftello ()
63 関数は、
64 それぞれ
65 .BR fseek (3)
66 および
67 .BR ftell (3)
68 と同一の機能を持つ
69 .RB ( fseek (3)
70 を見よ) が、ただし
71 .BR fseeko ()
72 関数の \fIoffset\fP 引数と
73 .BR ftello ()
74 の返り値が、
75 \fIlong\fP ではなく \fIoff_t\fP になっている。
76 .LP
77 .\"O On many architectures both \fIoff_t\fP and \fIlong\fP are 32-bit types,
78 .\"O but compilation with
79 多くのアーキテクチャでは
80 \fIoff_t\fP も \fIlong\fP も共に 32 ビットの型であるが、
81 .RS
82 .nf
83
84 #define _FILE_OFFSET_BITS 64
85
86 .fi
87 .RE
88 .\"O .PP
89 .\"O will turn \fIoff_t\fP into a 64-bit type.
90 でコンパイルすると \fIoff_t\fP は 64 ビット型となる。
91 .\"O .SH RETURN VALUE
92 .SH 返り値
93 .\"O On successful completion,
94 .\"O .BR fseeko ()
95 .\"O returns 0, while
96 .\"O .BR ftello ()
97 .\"O returns the current offset.
98 .\"O Otherwise, \-1 is returned and
99 .\"O .I errno
100 .\"O is set to indicate the error.
101 成功した場合、
102 .BR fseeko ()
103 は 0 を、
104 .BR ftello ()
105 は現在のオフセットを返す。
106 失敗した場合、\-1 を返し、
107 .I errno
108 にエラーを示す値をセットする。
109 .\"O .SH ERRORS
110 .SH エラー
111 .\"O See the ERRORS in
112 .\"O .BR fseek (3).
113 .BR fseek (3)
114 の「エラー」の節を参照。
115 .\"O .SH "CONFORMING TO"
116 .SH 準拠
117 SUSv2, POSIX.1-2001.
118 .\"O .SH NOTES
119 .SH 注意
120 .\"O These functions are found on System V-like systems.
121 .\"O They are not present in libc4, libc5, glibc 2.0
122 .\"O but are available since glibc 2.1.
123 これらの関数は System V 的なシステムにある。
124 libc4, libc5, glibc 2.0 にはなかったが、
125 glibc 2.1 から使えるようになった。
126 .\"O .SH "SEE ALSO"
127 .SH 関連項目
128 .BR fseek (3)