Moves the current read-write file pointer by an offset expressed as a 32-bit integer.
Deprecated
This feature has been removed from the Web standards. Though some browsers may still support it, it is in the process of being dropped. Do not use it in old or new projects. Pages or Web apps using it may break at any time.
PR_Seek64
.
Syntax
#include <prio.h> PRInt32 PR_Seek( PRFileDesc *fd, PRInt32 offset, PRSeekWhence whence);
Parameters
The function has the following parameters:
fd
- A pointer to a
PRFileDesc
object. offset
- A value, in bytes, used with the whence parameter to set the file pointer. A negative value causes seeking in the reverse direction.
whence
- A value of type
PRSeekWhence
that specifies how to interpret theoffset
parameter in setting the file pointer associated with the fd parameter. The value for thewhence
parameter can be one of the following:PR_SEEK_SET
. Sets the file pointer to the value of theoffset
parameter.PR_SEEK_CUR
. Sets the file pointer to its current location plus the value of theoffset
parameter.PR_SEEK_END
. Sets the file pointer to the size of the file plus the value of theoffset
parameter.
Returns
The function returns one of the following values:
- If the function completes successfully, it returns the resulting file pointer location, measured in bytes from the beginning of the file.
- If the function fails, the file pointer remains unchanged and the function returns -1. The error code can then be retrieved with
PR_GetError
.
Description
Here's an idiom for obtaining the current location of the file pointer for the file descriptor fd
:
PR_Seek(fd, 0, PR_SEEK_CUR)
See Also
If you need to move the file pointer by a large offset that's out of the range of a 32-bit integer, use PR_Seek64
. New code should use PR_Seek64
so that it can handle files larger than 2 GB.