seek()

语法

File.seek( <offset>, [where] )

类别

File

描述

移动文件游标。

参数

参数名参数类型默认值描述是否必填
offsetint—-游标的偏移量是
wherecharb移动模式否

where 参数可选值如下表：

可选值描述
b文件偏移量为 offset
c文件偏移量为当前文件游标的偏移量加上 offset
e文件偏移量为文件的大小加上 offset

Note :

当 where 参数为 “e” 时，参数 offset 可以为负数。

返回值

无返回值。

错误

如果出错则抛异常，并输出错误信息，可以通过getLastErrMsg()获取错误信息或通过getLastError()获取错误码。

关于错误处理可以参考常见错误处理指南。

常见错误可参考错误码。

示例

  • 打开一个文件，获取文件描述符；

    1. > var file = new File( "/opt/sequoiadb/file.txt" )
    2. > file.read()
    3. 0:sequoiadb is wonderful.
    4. 1:wonderful sequoiadb.

  • 移动文件游标，从文件开头位置执行偏移；

    1. > file.seek(2)
    2. > file.read()
    3. sequoiadb is wonderful.
    4. 1:wonderful sequoiadb.
    5. > file.seek( 2, "b" )
    6. > file.read()
    7. sequoiadb is wonderful.
    8. 1:wonderful sequoiadb.

  • 移动文件游标，从文件当前的游标位置执行偏移；

    1. > file.seek(2)
    2. > file.seek( 2, "c" )
    3. > file.read()
    4. quoiadb is wonderful.
    5. 1:wonderful sequoiadb.

  • 把游标移至文件末尾。

    1. > file.seek(0)
    2. > file.seek( -5, "e" )
    3. > file.read()
    4. adb.