lseek函数

转自：https://baike.baidu.com/item/lseek/6385407?fr=aladdin

相关函数

dup，open，fseek

表头文件

#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）；