Delete a file.

int _unlink(
   const char *filename
);
int _wunlink(
   const wchar_t *filename
);

filename
Name of file to remove.

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 a directory, or to ENOENT, which means the file or path is not found.

See _doserrno, errno, _sys_errlist, and _sys_nerr for more information on these, and other, return codes.

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.

By default, this function's global state is scoped to the application. To change this, see Global state in the CRT.

For additional compatibility information, see Compatibility.

This program uses _unlink to delete CRT_UNLINK.TXT.

// crt_unlink.c

#include <stdio.h>

int main( void )
{
   if( _unlink( "crt_unlink.txt" ) == -1 )
      perror( "Could not delete 'CRT_UNLINK.TXT'" );
   else
      printf( "Deleted 'CRT_UNLINK.TXT'\n" );
}

This file will be deleted.

Deleted 'CRT_UNLINK.TXT'

File Handling
_close
remove, _wremove