# PXFFSEEK

POSIX Subroutine: Modifies a file position.

## Module

USE IFPOSIX

CALL PXFFSEEK (lunit,ioffset,iwhence,ierror)

lunit | (Input) INTEGER(4). A Fortran logical unit.
ioffset | (Input) INTEGER(4). The number of bytes away from iwhence to place the pointer.
iwhence | (Input) INTEGER(4). The position within the file. The value must be one of the following constants (defined in `stdio.h`):
SEEK_SET = 0 | Offset from the beginning of the file.
SEEK_CUR = 1 | Offset from the current position of the file pointer.
SEEK_END = 2 | Offset from the end of the file.
ierror | (Output) INTEGER(4). The error status.

If successful, ierror is set to zero; otherwise, an error code. Possible error codes are:

- EINVAL: No file is connected to lunit, iwhence is not a proper value, or the resulting offset is invalid.

- ESPIPE: lunit is a pipe or FIFO.

- EEND: The end of the file has been reached.

The PXFFSEEK subroutine modifies the position of the file connected to unit lunit.

Parent topic: POSIX* Library Routines