1. 程式人生 > >c語言函式lseek函式

c語言函式lseek函式

原文連結:http://c.biancheng.net/cpp/html/236.html

相關函式:dup, open, fseek

標頭檔案:#include <sys/types.h> #include <unistd.h>

定義函式:off_t lseek(int fildes, off_t offset, int whence);

函式說明:
每一個已開啟的檔案都有一個讀寫位置, 當開啟檔案時通常其讀寫位置是指向檔案開頭, 若是以附加的方式開啟檔案(如O_APPEND), 則讀寫位置會指向檔案尾. 當read()或write()時, 讀寫位置會隨之增加,lseek()便是用來控制該檔案的讀寫位置. 引數fildes 為已開啟的檔案描述詞, 引數offset 為根據引數whence來移動讀寫位置的位移數.

    引數 whence 為下列其中一種:
    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 會存放錯誤程式碼.

附加說明:Linux 系統不允許lseek()對tty 裝置作用, 此項動作會令lseek()返回ESPIPE.

以下程式建立一個有空洞的檔案:

  /* Standard C header */
        #include <stdio.h>
        /* Unix header */
        #include <fcntl.h>
        #include <unistd.h>
        #include <sys/stat.h>

        char    buf1[] = "abcdefghij";
        char    buf2[] = "ABCDEFGHIJ";

        int main(void)
        {
            int     fd, size;

            if ((fd = creat("file.hole", S_IRUSR|S_IWUSR)) < 0)
            {
                printf("creat error\n");
                return -1;
            }

            size = sizeof buf1 - 1;
            if (write(fd, buf1, size) != size)
            {
                printf("buf1 write error\n");
                return -1;
            }
            /* offset now = 10 */

            if (lseek(fd, 16384, SEEK_SET) == -1)
            {
                printf("lseek error\n");
                return -1;
            }
            /* offset now = 16384 */

            size = sizeof buf2 - 1;
            if (write(fd, buf2, size) != size)
            {
                printf("buf2 write error\n");
                return -1;
            }
            /* offset now = 16394 */

            return 0;
        }