This shows you the differences between two versions of the page.
— |
frewind [2006/10/06 19:08] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | # $EPIC: frewind.txt,v 1.2 2006/10/06 19:08:28 jnelson Exp $ | ||
+ | ======Synopsis:====== | ||
+ | $[[frewind]](<file descriptor>) | ||
+ | |||
+ | ======Technical:====== | ||
+ | This function resets the file pointer back to the beginning of the file. | ||
+ | The next [[read]] or [[readb]] in the file after this call will read the | ||
+ | first line of the file. | ||
+ | |||
+ | This function returns the [[ferror]] value, which is zero if the operation | ||
+ | succeeds and is non-zero if an error occurs. | ||
+ | |||
+ | The //file descriptor// must have been a value previously returned by | ||
+ | the [[open]] function. | ||
+ | |||
+ | ======Returns:====== | ||
+ | <file> | ||
+ | -1 Error: //file descriptor// was not previously returned by [[open]] | ||
+ | 0 The file pointer was reset to the beginning | ||
+ | 1 The file pointer could not be reset. | ||
+ | </file> | ||