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.

AUTHOR

       MongoDB, Inc

COPYRIGHT

       2017-present, MongoDB, Inc

1.26.0                                            Mar 31, 2024                        MONGOC_GRIDFS_FILE_SEEK(3)