_unlink, _wunlink

Odstraňte soubor.

Syntaxe

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

Parametry

filename
Název souboru, který chcete odebrat.

Vrácená hodnota

Každá z těchto funkcí v případě úspěchu vrátí hodnotu 0. V opačném případě funkce vrátí hodnotu -1 a nastaví errno hodnotu EACCES, což znamená, že cesta určuje soubor jen pro čtení nebo adresář nebo do ENOENT, což znamená, že soubor nebo cesta se nenašla.

Další informace o návratových kódech naleznete v tématu errno, _doserrno, _sys_errlista _sys_nerr.

Poznámky

Funkce _unlink odstraní soubor určený filename. _wunlinkje verze širokého znaku _unlinkfilename ; argument je _wunlink řetězec širokého znaku. Tyto funkce se chovají stejně jinak.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Mapování rutin obecného textu

Rutina TCHAR.H	_UNICODE a _MBCS není definován	_MBCS definovaný	_UNICODE definovaný
_tunlink	_unlink	_unlink	_wunlink

Požadavky

Rutina	Požadovaný hlavičkový soubor
_unlink	<io.h> a <stdio.h>
_wunlink	<io.h> nebo <wchar.h>

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Příklad kódu

Tento program používá _unlink k odstranění 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" );
}

Vstup: crt_unlink.txt

This file will be deleted.

Ukázkový výstup

Deleted 'CRT_UNLINK.TXT'

Viz také

Zpracování souborů
_close
remove, _wremove