_unlink, _wunlink

Nach oben zu stdio.h - Index

Header-Datei

stdio.h

Kategorie

Eingabe-/Ausgaberoutinen

Prototyp

int _unlink(const char *filename);

int _wunlink(const wchar_t *filename);

Beschreibung

Löscht eine Datei.

_unlink löscht die mit filename angegebene Datei. Der Dateiname kann jeder beliebige Laufwerks-, Pfad- und Dateiname sein. Platzhalter sind nicht erlaubt.

Schreibgeschützte Dateien können durch diesen Aufruf nicht gelöscht werden. Um schreibgeschützte Dateien zu entfernen, muss das Schreibschutzattribut zuerst mit chmod oder _rtl_chmod geändert werden.

Anmerkung:  Wenn die Datei geöffnet ist, muss sie geschlossen werden, bevor sie gelöscht wird.

_wunlink ist die Unicode-Version von _unlink. Die Unicode-Version akzeptiert einen Zeichenstring vom Typ wchar_t als Dateinamen. Ansonsten haben die Funktionen das gleiche Verhalten.

Rückgabewert

Bei erfolgreicher Ausführung gibt _unlink 0 zurück.

Andernfalls gibt die Funktion -1 zurück und weist der globalen Variablen errno einen der folgenden Werte zu:

EACCES	Permission denied (Zugriff verweigert)
ENOENT	Path or file name not found (Pfad oder Dateiname nicht gefunden)

Beispiel

 #include <stdio.h>
 #include <io.h>
 int main(void)
 {
    FILE *fp = fopen("junk.jnk","w");
    int status;
    fprintf(fp,"junk");
    status = access("junk.jnk",0);
    if (status == 0)
       printf("File exists\n");
    else
       printf("File doesn't exist\n");
    fclose(fp);
    unlink("junk.jnk");
    status = access("junk.jnk",0);
    if (status == 0)
       printf("File exists\n");
    else
       printf("File doesn't exist\n");
    return 0;
 }

Portabilität

	POSIX	Win32	ANSI C	ANSI C++
_unlink	+	+
_wunlink		Nur NT