LSEEK

名前

書式

off_t lseek(int fildes, off_t offset, int whence);  

説明

SEEK_SET

オフセットは offset バイトに設定される。

SEEK_CUR

オフセットは現在位置に offset バイトを足した位置になる。

SEEK_END

オフセットはファイルのサイズに offset バイトを足した位置になる。

lseek() 関数は、オフセットをファイルの末尾を越えた位置に設定できる (但し、これによりファイルのサイズが変わらない)。 もしデータがこのオフセット位置以降に書き込まれた場合、 間の空隙の部分 ("穴 (hole)") の読み出しがあると、 実際にそこにデータを書き込まれるまでは NULL バイト ('\0') の列が返される。  

返り値

エラー

EBADF

fildes がオープンされたファイルディスクリプタでない。

EINVAL

whence が SEEK_SET, SEEK_CUR, SEEK_END のどれでもない。 または、seek の結果、ファイル・オフセットが負になってしまうか、 seek 可能なデバイスの末尾を越えてしまう。 EOVERFLOW 結果のファイル・オフセットを off_t 型で表現することができない。

ESPIPE

fildes がパイプ、ソケット、FIFO を参照している。

準拠

注意

いくつかのデバイスでは seek ができない。 POSIX はどのデバイスが lseek() に対応すべきかは規定していない。

Linux では、 tty デバイスに lseek() を使用すると ESPIPE を返す。

古いコードを変換する時は whence の値を以下のマクロに置き換えること:

old	new
0	SEEK_SET
1	SEEK_CUR
2	SEEK_END
L_SET	SEEK_SET
L_INCR	SEEK_CUR
L_XTND	SEEK_END

返り値の型は、SVr1-3 では off_t ではなく long であり、 BSD では int である。

dup(2) や fork(2) で作成されたファイルディスクリプタは、現在のファイル位置ポインタ (current file position pointer) を共有しているので、 このようなファイルで移動を行うと競合状態を引き起こす可能性がある。  

関連項目

Index

名前

書式

説明

返り値

エラー

準拠

注意

関連項目