Difference between revisions of "cpp/io/c/fsetpos"
From cppreference.com
m (Update links.) |
(note about seek+output making the rest of a wide stream undefined) |
||
| Line 19: | Line 19: | ||
===Return value=== | ===Return value=== | ||
{{c|0}} upon success, nonzero value otherwise. Also, sets {{lc|errno}} on failure. | {{c|0}} upon success, nonzero value otherwise. Also, sets {{lc|errno}} on failure. | ||
| + | |||
| + | ===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. | ||
===See also=== | ===See also=== | ||
Revision as of 05:58, 4 September 2014
| 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.
Contents |
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 |
Return value
0 upon success, nonzero value otherwise. Also, sets errno on failure.
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.
See also
| gets the file position indicator (function) | |
| returns the current file position indicator (function) | |
| moves the file position indicator to a specific location in a file (function) | |
| C documentation for fsetpos
| |
