_unlink, _wunlink

Delete a file.

int_unlink(constchar*filename);

int_wunlink(constwchar_t*filename);

For additional compatibility information, see Compatibility in the Introduction.

Libraries

Return Value

Each of these functions returns 0 if successful. Otherwise, the function returns –1 and sets errno to EACCES, which means the path specifies a read-only file, or to ENOENT, which means the file or path is not found or the path specified a directory.

Parameter

filename

Name of file to remove

Remarks

The _unlink function deletes the file specified by filename. _wunlink is a wide-character version of _unlink; the filename argument to _wunlink is a wide-character string. These functions behave identically otherwise.

Generic-Text Routine Mappings

Example

/* UNLINK.C: This program uses _unlink to delete UNLINK.OBJ. */

#include <stdio.h>

void main( void )
{
   if( _unlink( "unlink.obj" ) == -1 )
      perror( "Could not delete 'UNLINK.OBJ'" );
   else
      printf( "Deleted 'UNLINK.OBJ'\n" );
}

Output

Deleted 'UNLINK.OBJ'

File Handling Routines

See Also   _close, remove