remove, _wremove

Löschen Sie eine Datei.

Syntax

int remove(
   const char *path
);
int _wremove(
   const wchar_t *path
);

Parameter

path
Pfad der zu löschenden Datei.

Rückgabewert

Jede dieser Funktionen gibt 0 zurück, wenn die Datei erfolgreich gelöscht wird. Andernfalls wird -1 zurückgegeben und festgelegt errno EACCES , um anzugeben, dass der Pfad eine schreibgeschützte Datei angibt, ein Verzeichnis angibt oder die Datei geöffnet ist oder um ENOENT anzugeben, dass der Dateiname oder Pfad nicht gefunden wurde.

Weitere Informationen zu Rückgabecodes finden Sie unter , , _doserrno, _sys_errlistund _sys_nerr.errno

Hinweise

Die remove Funktion löscht die durch path. _wremove angegebene Datei eine breitzeichenige Version von _remove; das path Argument _wremove ist eine breite Zeichenfolge. _wremove und _remove verhalten sich andernfalls identisch. Alle Handles zu einer Datei müssen geschlossen werden, bevor sie gelöscht werden kann.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Mapping generischer Textroutinen

TCHAR.H-Routine	_UNICODE und _MBCS nicht definiert	_MBCS definiert	_UNICODE definiert
_tremove	remove	remove	_wremove

Anforderungen

Routine	Erforderlicher Header
remove	<stdio.h> oder <io.h>
_wremove	<stdio.h> oder <wchar.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Libraries

Alle Versionen der C-Laufzeitbibliotheken.

Beispiel

// crt_remove.c
/* This program uses remove to delete crt_remove.txt */

#include <stdio.h>

int main( void )
{
   if( remove( "crt_remove.txt" ) == -1 )
      perror( "Could not delete 'CRT_REMOVE.TXT'" );
   else
      printf( "Deleted 'CRT_REMOVE.TXT'\n" );
}

Eingabe: crt_remove.txt

This file will be deleted.

Beispielausgabe

Deleted 'CRT_REMOVE.TXT'

Siehe auch

Dateibehandlung
_unlink, _wunlink