PR_Seek

将当前读写文件指针移动由一个表示为 32 位整数的偏移量。

已弃用
不再推荐使用此功能。尽管某些浏览器可能仍然支持它，但它可能已从相关的 Web 标准中删除，可能正在被删除过程中，或者可能仅出于兼容性目的而保留。避免使用它，并尽可能更新现有代码；请参阅此页面底部的兼容性表，以指导您的决策。请注意，此功能可能随时停止工作。

已弃用，建议使用 PR_Seek64。

语法

#include <prio.h>

PRInt32 PR_Seek(
  PRFileDesc *fd,
  PRInt32 offset,
  PRSeekWhence whence);

参数

该函数具有以下参数

fd

指向 PRFileDesc 对象的指针。

offset

一个以字节为单位的值，与 whence 参数一起使用以设置文件指针。负值会导致反向查找。

whence

类型为 PRSeekWhence 的值，用于指定如何解释 offset 参数以设置与 fd 参数关联的文件指针。 whence 参数的值可以是以下值之一

  • PR_SEEK_SET。将文件指针设置为 offset 参数的值。

  • PR_SEEK_CUR。将文件指针设置为其当前位置加上 offset 参数的值。

  • PR_SEEK_END。将文件指针设置为文件大小加上 offset 参数的值。

返回值

该函数返回以下值之一

  • 如果函数成功完成，它将返回结果文件指针位置，以文件开头处的字节数为单位。

  • 如果函数失败，则文件指针保持不变，函数返回 -1。然后可以使用 PR_GetError 获取错误代码。

描述

以下是如何获取文件描述符 fd 的文件指针的当前位置的惯用法

PR_Seek(fd, 0, PR_SEEK_CUR)

另请参阅

如果您需要将文件指针移动超出 32 位整数范围的大偏移量，请使用 PR_Seek64。新代码应使用 PR_Seek64，以便它可以处理大于 2 GB 的文件。