SYNOPSIS
#include
<stdio.h>
int remove(char
*filename);
int _remove_r(void
*reent, char
*filename);
DESCRIPTION
Use remove
to dissolve the association between
a particular filename (the string at filename)
and the file it represents. After calling remove
with a particular filename, you will
no longer be able to open the file by that name.
In this implementation, you may use remove on an open file without error; existing file descriptors for the file will continue to access the file’s data until the program using them closes the file.
The alternate function, _remove_r, is a reentrant version. The extra argument, reent, is a pointer to a reentrancy structure.
RETURNS
remove
returns 0
if it succeeds, -1
if it fails.
COMPLIANCE
ANSI C requires
remove,
but only specifies that the result on failure be nonzero. The behavior
of remove
when you call it on an open file may
vary among implementations.
Supporting OS subroutine required: unlink.
0