HP C/iX Library Reference Manual (30026-90004)

292 Chapter5

HP C/iX Library Function Descriptions

remove

Purges an existing ﬁle.

Syntax

#include <stdio.h>

int remove (const char *

filename

);

Parameters

filename

A pointer to a character array containing the name of a ﬁle to purge. The

string must be terminated by a null character.

Return Values

0 The ﬁle is successfully purged.

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

ENOENT The ﬁle does not exist.

ESYSERR A call to a system intrinsic failed.

Description

The remove function purges the speciﬁed ﬁle from the ﬁle system. The call fails if

filename

references an open ﬁle.