# $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>