_rmdir, _wrmdir

Nach oben zu Dir.h - Index

Header-Datei

dir.h

Kategorie

Verzeichnisbearbeitungsroutinen

Prototyp

int _rmdir(const char *path);

int _wrmdir(const wchar_t *path);

Beschreibung

Entfernt ein Verzeichnis.

_rmdir löscht das Verzeichnis, dessen Pfad in path angegeben ist. Das durch path bezeichnete Verzeichnis

• muss leer sein,
• darf nicht das aktuelle Arbeitsverzeichnis sein,
• darf nicht das Stammverzeichnis sein.

Rückgabewert

_rmdir gibt 0 zurück, wenn das Verzeichnis gelöscht wurde. Bei einem Fehler wird der Wert -1 zurückgegeben und der globalen Variable errno einer der folgenden Werte zugewiesen:

EACCES	Zugriff verweigert
ENOENT	Pfad- oder Dateifunktion nicht gefunden
ENOTEMPTY	Übergebenes Verzeichnis war nicht leer

Beispiel

#include <stdio.h> #include <process.h> #include <dir.h> #define DIRNAME "testdir.$$$" int main(void) { int stat; stat = mkdir(DIRNAME); if (!stat) printf("Verzeichnis erstellt\n"); else { printf("Verzeichnis kann nicht erstellt werden\n"); exit(1); } getchar(); system("dir/p"); getchar(); stat = rmdir(DIRNAME); if (!stat) printf("\nVerzeichnis gelöscht\n"); else { perror("\nVerzeichnis kann nicht gelöscht werden\n"); exit(1); } return 0; }
 

Portabilität

	POSIX	Win32	ANSI C	ANSI C++
_rmdir	+	+
_wrmdir		Nur NT