Synopsis:

        sys_fheof(file_handle)

Arguments:

        file_handle       -   The file handle

Description:    This function checks whether the end of file has been reached when reading from files.     If the current file position is past the end of file the this function will return 1, otherwise it will return 0.

Return Value:   Will return 1 if end of file has been reached, otherwise will return 0 or a negative error code.