Udostępnij za pośrednictwem

remove, _wremove

  • Artykuł

Usuń plik.

Składnia

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

Parametry

path
Ścieżka pliku do usunięcia.

Wartość zwracana

Każda z tych funkcji zwraca wartość 0, jeśli plik został pomyślnie usunięty. W przeciwnym razie zwraca wartość -1 i ustawia errno wartość , aby EACCES wskazać, że ścieżka określa plik tylko do odczytu, określa katalog lub plik jest otwarty albo ENOENT wskazuje, że nazwa pliku lub ścieżka nie została znaleziona.

Aby uzyskać więcej informacji na temat kodów zwracanych, zobacz errno, _doserrno, _sys_errlisti _sys_nerr.

Uwagi

Funkcja remove usuwa plik określony przez _wremove path. jest wersją _removeszerokoznakową ; argument to path _wremove ciąg o szerokim znaku. _wremove i _remove zachowywać się identycznie inaczej. Wszystkie dojścia do pliku muszą zostać zamknięte, zanim będzie można go usunąć.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Mapowania procedur tekstu ogólnego

TCHAR.H rutyna _UNICODE i _MBCS niezdefiniowane _MBCS zdefiniowany _UNICODE zdefiniowany
_tremove remove remove _wremove

Wymagania

Procedura Wymagany nagłówek
remove <stdio.h> lub <io.h>
_wremove <stdio.h> lub <wchar.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Biblioteki

Wszystkie wersje bibliotek czasu wykonywania języka C.

Przykład

// 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" );
}

Wkład: crt_remove.txt

This file will be deleted.

Przykładowe dane wyjściowe

Deleted 'CRT_REMOVE.TXT'

Zobacz też

Obsługa plików
_unlink, _wunlink