File and Path Function

int unlink(const char *filename);

int _unlink(const char *filename);

int _wunlink(const wchar_t *filename);

int _tunlink(const TCHAR *filename);

Internationalization (I18n) Function Overview

The unlink and _unlink functions delete the file named filename. It returns 0 if successful; otherwise it returns -1 and sets the global errno variable to the error number.

On Windows platforms, _wunlink is the wide-character version of _unlink; its argument is a wide-character string. There is no ANSI wide-character equivalent.

_tunlink is the Windows-only Generic version of the function; with the _MBCS or _UNICODE compiler flags determining its mapping to either _unlink or _wunlink.

I18n Issues

Use the appropriate version of the function as required for internationalization support, noting the following:

On ANSI UTF-16 platforms, use a conversion function to convert the wide-character string to a multibyte-character string and then call unlink.

See Pathnames for a discussion of path and filename considerations in an internationalized application.

Recommended Replacements*

ANSI UTF-8	unlink
ANSI UTF-16	convert and call unlink
Microsoft Windows MBCS	_unlink
Microsoft Windows Unicode	_wunlink
Microsoft Windows Generic	_tunlink

File and Path Functions