# $EPIC: frewind.txt,v 1.2 2006/10/06 19:08:28 jnelson Exp $

Synopsis:

$frewind(

)
 
======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.