HP 3000 Manuals

HP C/iX Library Reference Manual

remove 

Purges an existing file.

Syntax 

     #include <stdio.h>
     int remove (const char *filename);

Parameters 

filename      A pointer to a character array containing the name of a
              file to purge.  The string must be terminated by a null
              character.

Return Values 

0             The file is successfully purged.

-1            An error occurred and errno is set to one of the following
              values:

              ENOENT        The file does not exist.
              ESYSERR       A call to a system intrinsic failed.

Description 

The remove function purges the specified file from the file system.  The
call fails if filename references an open file.

See Also 

ANSI C 4.9.4.1, POSIX.1 8.1

MPE/iX 5.0 Documentation