remove, _wremove

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_wremovepath. 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 Rutynowych	_UNICODE i _MBCS niezdefiniowane	_MBCS Zdefiniowane	_UNICODE Zdefiniowane
_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" );
}

Wejście: 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