_lseek、_lseeki64
指定した場所にファイル ポインターを移動します。
long _lseek(
int fd,
long offset,
int origin
);
__int64 _lseeki64(
int fd,
__int64 offset,
int origin
);
パラメーター
fd
開いているファイルを参照するファイル記述子。オフセット
原点 からのバイト数。元
初期位置。
戻り値
_lseek はファイルの先頭からのオフセットを新しい位置のサイズをバイト単位で返します。_lseeki64 は64 ビットの整数オフセットを返します。関数の戻り値 –エラーを示す 1L。無効なパラメーター渡られたらしそれらのファイル記述子などまたは 元 の値が無効でありファイルの先頭に無効なパラメーター ハンドラーが呼び出される前に オフセット によって指定された位置に パラメーターの検証 に従って。実行の継続が許可 EBADFは -1L に関数の設定 errno。検索できないデバイス (ターミナルやプリンターなど)戻り値は未定義です。
これらのプロパティおよびそのほかのエラー コードに関する詳細については_doserrnoerrno_sys_errlist と _sys_nerr を参照してください。
解説
_lseek の関数は 原点 からの オフセット バイトの新しい場所に fd に関連付けられたファイル ポインターを移動します。ファイルで次の操作が新しい場所に発生します。 元の 引数は Stdio.h で定義されている定数の 1 種類があります。
SEEK_SET
ファイルの先頭。SEEK_CUR
ファイル ポインターの現在位置。SEEK_END
end of file。
ファイルまたはファイルの末尾を超えるポインターの任意の位置の変更に _lseek を使用できます。
必要条件
ルーチン |
必須ヘッダー |
---|---|
_lseek |
<io.h> |
_lseeki64 |
<io.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
ライブラリ
C ランタイム ライブラリのすべてのバージョン。
使用例
// crt_lseek.c
/* This program first opens a file named lseek.txt.
* It then uses _lseek to find the beginning of the file,
* to find the current position in the file, and to find
* the end of the file.
*/
#include <io.h>
#include <fcntl.h>
#include <stdlib.h>
#include <stdio.h>
#include <share.h>
int main( void )
{
int fh;
long pos; /* Position of file pointer */
char buffer[10];
_sopen_s( &fh, "crt_lseek.c_input", _O_RDONLY, _SH_DENYNO, 0 );
/* Seek the beginning of the file: */
pos = _lseek( fh, 0L, SEEK_SET );
if( pos == -1L )
perror( "_lseek to beginning failed" );
else
printf( "Position for beginning of file seek = %ld\n", pos );
/* Move file pointer a little */
_read( fh, buffer, 10 );
/* Find current position: */
pos = _lseek( fh, 0L, SEEK_CUR );
if( pos == -1L )
perror( "_lseek to current position failed" );
else
printf( "Position for current position seek = %ld\n", pos );
/* Set the end of the file: */
pos = _lseek( fh, 0L, SEEK_END );
if( pos == -1L )
perror( "_lseek to end failed" );
else
printf( "Position for end of file seek = %ld\n", pos );
_close( fh );
}
型 : crt_lseek.c_input
Line one.
Line two.
Line three.
Line four.
Line five.
出力
Position for beginning of file seek = 0
Position for current position seek = 10
Position for end of file seek = 57