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 isn't found.

For more information about return codes, see errno, _doserrno, _sys_errlist, and _sys_nerr.

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 behavior, see Global state in the CRT.

For more 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