_lseek、_lseeki64
将文件指针移到指定位置。
long _lseek(
int fd,
long offset,
int origin
);
__int64 _lseeki64(
int fd,
__int64 offset,
int origin
);
参数
fd
引用开启文件的描述符。偏移量
原始字节数。原始
初始位置。
返回值
_lseek 返回字节偏移量，从开头文件的新位置。 _lseeki64 返回在 64 位整数的偏移量。 函数返回 –1L 指示错误。 如果传递的参数无效，例如一个坏文件说明符或 原始 值无效或 偏移所 指定的位置是，在文件的开头，无效参数调用处理程序之前，如 参数验证所述。 如果允许执行继续，则这些功能将 errno 设置为 EBADF，并返回 -1L。 在设备上不能查找 (如运行和打印机)，返回值是不确定的。
有关这些属性和其他错误代码的详细信息，请参阅 _doserrno、errno、_sys_errlist 和 _sys_nerr。
备注
_lseek 函数移动了文件指针与 fd 到偏离原点偏移量 为字节的新位置。 文件的下一操作在新位置。 原点 参数必须是下列常数之一，在 Stdio.h 定义。
SEEK_SET
文件名的开头。SEEK_CUR
文件指针的当前位置。SEEK_END
文件尾。
可以使用 _lseek 重新定位指针在文件中的任意位置或除文件外的末尾。
要求
例程 |
必需的标头 |
|---|---|
_lseek |
<io.h> |
_lseeki64 |
<io.h> |
有关更多兼容性信息，请参见“简介”中的兼容性。
库
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 );
}
Input: crt_lseek.c_input
Line one.
Line two.
Line three.
Line four.
Line five.
Output
Position for beginning of file seek = 0
Position for current position seek = 10
Position for end of file seek = 57