std::fsetpos - cppreference.com

##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# std::fsetpos

From cppreference.com
< cpp‎ | io‎ | c

Defined in header `<cstdio>` |  |
int fsetpos( std::FILE* stream, const std::fpos_t* pos ); |  |

Sets the file position indicator and the multibyte parsing state (if any) for the C file stream `stream` according to the value pointed to by `pos`.

Besides establishing new parse state and position, a call to this function undoes the effects of std::ungetc and clears the end-of-file state, if it is set.

If a read or write error occurs, the error indicator (std::ferror)for the stream is set.

### [edit] Parameters

stream | - | file stream to modify
pos | - | pointer to a fpos_t object obtained from std::fgetpos called on a stream associated with the same file

### [edit] Return value

​0​ upon success, nonzero value otherwise. Also, sets errno on failure.

### [edit] Notes

After seeking to a non-end position in a wide stream, the next call to any output function may render the remainder of the file undefined, e.g. by outputting a multibyte sequence of a different length.

### [edit] See also

fgetpos | gets the file position indicator (function) [edit]
ftell | returns the current file position indicator (function) [edit]
fseek | moves the file position indicator to a specific location in a file (function) [edit]
C documentation for fsetpos

Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/io/c/fsetpos&oldid=72572"