| Top |
Other File Reference FunctionsOther File Reference Functions — Miscellaneous functions for file references |
| void | glk_fileref_destroy () |
| frefid_t | glk_fileref_iterate () |
| glui32 | glk_fileref_get_rock () |
| void | glk_fileref_delete_file () |
| glui32 | glk_fileref_does_file_exist () |
void
glk_fileref_destroy (frefid_t fref);
Destroys a fileref which you have created. This does not
affect the disk file; it just reclaims the resources allocated by the
glk_fileref_create... function.
It is legal to destroy a fileref after opening a file with it (while the file is still open.) The fileref is only used for the opening operation, not for accessing the file stream.
frefid_t glk_fileref_iterate (frefid_t fref,glui32 *rockptr);
Iterates through all the existing filerefs. See Iterating Through Opaque Objects.
glui32
glk_fileref_get_rock (frefid_t fref);
Retrieves the file reference fref
's rock value.
See Rocks.
void
glk_fileref_delete_file (frefid_t fref);
Deletes the file referred to by fref
. It does not destroy fref
itself.
You should only call this with a fileref that refers to an existing file.