Linux ---lseek() 函式

2puT發表於2016-07-09

每個開啟的檔案都有一個與其相關連的“當前檔案偏移量”( current file offset )。它通常是一個非負整數,用以度量從檔案開始處計算的位元組數。通常,讀、寫操作都從當前檔案偏移量開始,並使偏移量增加所讀寫的位元組數。按系統預設情況,當開啟一個檔案時,除非指定 O_APPEND 選項,否則該偏移量設定為 0。

lseek呼叫僅將當前的檔案偏移量記錄在核心中,它並不引起任何的 I/O 操作。然後,該偏移量用於下一個讀或寫操作。

函式原型

#include<unistd.h>

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

引數fildes 為已開啟的檔案描述詞,引數offset 為根據引數whence來移動讀寫位置的位移數。

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取值不當。

注:Linux系統不允許lseek()對tty裝置作用,此項動作會令lseek()返回ESPIPE。

相關文章