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.