_unlink, _wunlink

Usuń plik.

Składnia

int _unlink(
   const char *filename
);
int _wunlink(
   const wchar_t *filename
);

Parametry

filename
Nazwa pliku do usunięcia.

Wartość zwracana

Każda z tych funkcji zwraca wartość 0 w przypadku powodzenia. W przeciwnym razie funkcja zwraca wartość -1 i ustawia errno wartość EACCES, co oznacza, że ścieżka określa plik tylko do odczytu lub katalog albo ENOENTwartość , co oznacza, że plik lub ścieżka nie zostanie znaleziona.

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

Uwagi

Funkcja _unlink usuwa plik określony przez filename. _wunlink jest wersją szerokoznakową ; _unlinkargument to filename_wunlink ciąg o szerokim znaku. Te funkcje zachowują się identycznie inaczej.

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

Mapowania procedur tekstu ogólnego

Procedura TCHAR.H	_UNICODE i _MBCS niezdefiniowane	_MBCS Zdefiniowane	_UNICODE Zdefiniowane
_tunlink	_unlink	_unlink	_wunlink

Wymagania

Procedura	Wymagany nagłówek
_unlink	<io.h> i <stdio.h>
_wunlink	<io.h> lub <wchar.h>

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

Przykład kodu

Ten program używa _unlink do usuwania CRT_UNLINK.TXT.

// crt_unlink.c

#include <stdio.h>

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

Dane wejściowe: crt_unlink.txt

This file will be deleted.

Przykładowe dane wyjściowe

Deleted 'CRT_UNLINK.TXT'

Zobacz też

Obsługa plików
_close
remove, _wremove