_rmdir, _wrmdir
Go Up to dir.h Index
Header File
dir.h
Category
Directory Control Routines
Prototype
int _rmdir(const char *path);
int _wrmdir(const wchar_t *path);
Description
Removes a directory.
_rmdir deletes the directory whose path is given by path. The directory named by path
- must be empty
- must not be the current working directory
- must not be the root directory
Return Value
_rmdir returns 0 if the directory is successfully deleted. A return value of -1 indicates an error, and the global variable errno is set to one of the following values:
EACCES |
Permission denied |
ENOENT |
Path or file function not found |
ENOTEMPTY |
Directory passed was not empty |
Example
#include <stdio.h> #include <process.h> #include <dir.h> #define DIRNAME "testdir.$$$" int main(void) { int stat; stat = mkdir(DIRNAME); if (!stat) printf("Directory created\n"); else { printf("Unable to create directory\n"); exit(1); } getchar(); system("dir/p"); getchar(); stat = rmdir(DIRNAME); if (!stat) printf("\nDirectory deleted\n"); else { perror("\nUnable to delete directory\n"); exit(1); } return 0; }
Portability
POSIX | Win32 | ANSI C | ANSI C++ | |
---|---|---|---|---|
_rmdir |
+ |
+ |
||
_wrmdir |
NT only |