gfs_pio_seek

## Name

gfs_pio_seek — reposition a stream

## Synopsis

    #include <gfarm/gfarm.h>

`gfarm_error_t gfs_pio_seek(` | gf, |
| offset, |
| whence, |
| result`)`; |

`GFS_File gf`;
`gfarm_off_t offset`;
`int whence`;
`gfarm_off_t * result`;

## DESCRIPTION

The `gfs_pio_seek()` function sets the file position indicator for the file `gf`. The new position, measured in bytes, is obtained by adding `offset` bytes to the position specified by `whence`. If `whence` is set to GFARM_SEEK_SET, GFARM_SEEK_CUR, or GFARM_SEEK_END, the offset is relative to the start of the file, the current position indicator, or end-of-file, respectively. When `result` is not NULL, the new position returns to the address pointed by `result`.

## RETURN VALUES

`GFARM_ERR_NO_ERROR`

  The function terminated successfully.

`GFARM_ERR_NO_MEMORY`

  Insufficient memory was available.

`GFARM_ERR_INVALID_ARGUMENT`

  Specified whence or offset is invalid.

Other

  An error except the above occurred. The reason is shown by gfarm_error_string(3).

## SEE ALSO

gfs_pio_create(3), gfs_pio_open(3)