mongoc_gridfs_file_seek() — MongoDB C Driver 1.6.3

- MongoDB C Driver 1.6.3 »
- API Reference »
- mongoc_gridfs_file_t

# mongoc_gridfs_file_seek()

## Synopsis

    int
    mongoc_gridfs_file_seek (mongoc_gridfs_file_t *file, int64_t delta, int whence);

## Parameters

- `file`: A mongoc_gridfs_file_t.
- `delta`: The amount to move the file position. May be positive or negative.
- `whence`: One of SEEK_SET, SEEK_CUR or SEEK_END.

## Description

Adjust the file position pointer in the given file by `delta`, starting from the position `whence`. The `whence` argument is interpreted as in `fseek(2)`:

`SEEK_SET` | Set the position relative to the start of the file.
`SEEK_CUR` | Move `delta` relative to the current file position.
`SEEK_END` | Move `delta` relative to the end of the file.

On success, the file's underlying position pointer is set appropriately. On failure, the file position is NOT changed and errno is set to indicate the error.

## Errors

`EINVAL` | `whence` is not one of SEEK_SET, SEEK_CUR or SEEK_END.
`EINVAL` | The resulting file position would be negative.

## Returns

Returns 0 if successful; otherwise -1 and errno is set.

Created using Sphinx 1.5.3, based on Sphinx Readable Theme.