lseek()函数

来源：互联网发布：企业邮箱知乎编辑：程序博客网时间：2024/06/05 10:38

lseek函数（随机访问文件）

使用UNIX系统调用来读取文件内容时，系统究竟是从文件的哪一个位置读取数据，完全由文件指针决定。例如：刚开始读取数据时，文件指针通常是指向文件的起始位置。

中文名: lseek函数
外文名: lseek function
功能: 移动文件读/写指针

别名: 随机访问文件
头文件: #include <sys/types.h>
头文件：: #include <unistd.h>

简介

编辑

函数名: lseek

头文件：#include <sys/types.h> #include <unistd.h>

用法: off_t lseek(int handle, off_t offset, int fromwhere);

所有打开的文件都有一个当前文件偏移量（current file offset），以下简称为 cfo。cfo 通常是一个非负整数，用于表明文件开始处到文件当前位置的字节数。读写操作通常开始于 cfo，并且使 cfo 增大，增量为读写的字节数。文件被打开时，cfo 会被初始化为 0，除非使用了 O_APPEND 。

使用 lseek 函数可以改变文件的 cfo 。

lseek 的以下用法返回当前的偏移量：

off_t currpos;

currpos = lseek(fd, 0, SEEK_CUR);

这个技巧也可用于判断我们是否可以改变某个文件的偏移量。如果参数 fd（文件描述符）指定的是 pipe（管道）、FIFO 或者 socket，lseek 返回 -1 并且置 errno 为 ESPIPE。

对于普通文件（regular file），cfo 是一个非负整数。但对于特殊设备，cfo 有可能是负数。因此，我们不能简单地测试 lseek 的返回值是否小于 0 来判断 lseek 成功与否，而应该测试 lseek 的返回值是否等于 -1 来判断 lseek 成功与否。

lseek 仅将 cfo 保存于内核中，不会导致任何 I/O 操作。这个 cfo 将被用于之后的读写操作。

如果 offset 比文件的当前长度更大，下一个写操作就会把文件“撑大（extend）”。这就是所谓的在文件里创造“空洞（hole）”。没有被实际写入文件的所有字节由重复的 0 表示。空洞是否占用硬盘空间是由文件系统（file system）决定的。

程序例

编辑

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
#include<stdio.h>
#include<stdlib.h>
#include<string.h>
#include<unistd.h>
#include<sys/types.h>
#include<sys/stat.h>
#include<fcntl.h>
intmain(void)
{
inthandle;
char msg[]="Thisisatest";
char ch;
/*createafile*/
handle=open("TEST.$$$",O_CREAT|O_RDWR,S_IREAD|S_IWRITE);
/*writesomedatatothefile*/
write(handle,msg,strlen(msg));
/*seektothebeginingofthefile*/
lseek(handle,0,SEEK_SET);
/*readscharsfromthefileuntilwehitEOF*/
do
{
read(handle,&ch,1);
printf("%c",ch);
}while(!EOF);
close(handle);
return0;
}

Linux C

编辑

表头文件

#include<sys/types.h>

#include<unistd.h>

定义函数

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

函数说明

每一个已打开的文件都有一个读写位置，当打开文件时通常其读写位置是指向文件开头，若是以附加的方式打开文件(如O_APPEND)，则读写位置会指向文件尾。当read()或write()时，读写位置会随之增加，lseek()便是用来控制该文件的读写位置。参数fildes 为已打开的文件描述词，参数offset 为根据参数whence来移动读写位置的位移数。

Offset：偏移量，每一读写操作所需要移动的距离，单位是字节的数量，可正可负（向前移，向后移）。

参数

whence为下列其中一种:（SEEK_SET,SEEK_CUR和SEEK_END和依次为0，1和2）.

SEEK_SET 将读写位置指向文件头后再增加offset个位移量。

SEEK_CUR 以目前的读写位置往后增加offset个位移量。

SEEK_END 将读写位置指向文件尾后再增加offset个位移量。

当whence 值为SEEK_CUR 或SEEK_END时，参数offet允许负值的出现。

下列是较特别的使用方式:

1) 欲将读写位置移到文件开头时:

lseek（int fildes,0,SEEK_SET）；

2) 欲将读写位置移到文件尾时:

lseek（int fildes，0,SEEK_END）；

3) 想要取得目前文件位置时:

lseek（int fildes，0,SEEK_CUR）；

返回值

当调用成功时则返回目前的读写位置，也就是距离文件开头多少个字节。若有错误则返回-1，errno 会存放错误代码。

可能设置erron的错误代码：

EBADF: fildes不是一个打开的文件描述符。

ESPIPE:文件描述符被分配到一个管道、套接字或FIFO。

EINVAL:whence取值不当。^[1]

附加说明

Linux系统不允许lseek（）对tty装置作用，此项动作会令lseek（）返回ESPIPE。

SEEK_SET 等同于数字0 例如：lseek（int fildes,0,SEEK_SET）；=lseek（int fildes,0,0）；

SEEK_CUR 等同于数字1 例如：lseek（int fildes,0,SEEK_CUR）；=lseek（int fildes,0,1）；

SEEK_END 等同于数字2 例如：lseek（int fildes,0,SEEK_END）；=lseek（int fildes,0,2）；

0 0