A wrapper for the POSIX remove
function.
The remove
function deletes a name from the filesystem.
See your C library manual for more details about how remove
works on your system. On Unix, remove
removes also
directories, as it calls unlink for files and rmdir for directories. On Windows,
although remove
in the C library only works for files, this function tries first remove
and then if that fails
rmdir, and thus works for both files and directories. Note however, that on Windows, it is in general not
possible to remove a file that is open to some process, or mapped into memory.
If this function fails on Windows you can't infer too much from the errno value. rmdir is tried regardless of
what caused remove
to fail. Any errno value set by remove
will be overwritten by that set by
rmdir.
filename |
a pathname in the GLib file name encoding (UTF-8 on Windows) |
0 if the file was successfully removed, -1 if an error occurred |