Provided by: libmongoc-doc_1.23.1-1build1_all
NAME
mongoc_gridfs_file_seek - 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.
AUTHOR
MongoDB, Inc
COPYRIGHT
2017-present, MongoDB, Inc