File and Path Function

int rmdir(const char *dirname);

int _rmdir(const char *dirname);

int _wrmdir(const wchar_t *dirname);

int _trmdir(const TCHAR *dirname);

Internationalization (I18n) Function Overview

The rmdir function removes (deletes) the directory specified by dirname and returns 0 if successful. In the event of an error, the function returns -1 and sets the global variable errno with the error number.

_rmdir is the same as rmdir, supported on Windows platforms.

Also, on Windows platforms, _wrmdir is the wide-character version of _rmdir; its argument is a wide-character string. There is no ANSI wide-character equivalent.

_trmdir is the Windows-only Generic version of the function; with the _MBCS or _UNICODE compiler flags determining its mapping to either _rmdir or _wrmdir.

I18n Issues

Use the appropriate version of the function as required for internationalization support.

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

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

Recommended Replacements*

ANSI UTF-8	rmdir
ANSI UTF-16	convert and call rmdir
Microsoft Windows MBCS	_rmdir
Microsoft Windows Unicode	_wrmdir
Microsoft Windows Generic	_trmdir

File and Path Functions