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.