remove, _wremove

Odstraňte soubor.

Syntaxe

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

Parametry

path
Cesta k souboru, který se má odebrat.

Vrácená hodnota

Každá z těchto funkcí vrátí hodnotu 0, pokud se soubor úspěšně odstraní. V opačném případě vrátí hodnotu -1 a nastaví errno buď tak, aby EACCES indikovala, že cesta určuje soubor jen pro čtení, určuje adresář, nebo je soubor otevřený, nebo k ENOENT označení, že se název souboru nebo cesta nenašly.

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

Poznámky

Funkce remove odstraní soubor určený znakem path. _wremove je širokoznační verze _remove; path argument _wremove je řetězec širokého znaku. _wremove a _remove chovat se stejně jinak. Před odstraněním musí být všechny popisovače souboru zavřeny.

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

TCHAR.H rutina	_UNICODE a _MBCS není definován	_MBCS definovaný	_UNICODE definovaný
_tremove	remove	remove	_wremove

Požadavky

Rutina	Požadovaný hlavičkový soubor
remove	<stdio.h> nebo <io.h>
_wremove	<stdio.h> nebo <wchar.h>

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

Knihovny

Všechny verze knihoven runtime jazyka C.

Příklad

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

Vstup: crt_remove.txt

This file will be deleted.

Ukázkový výstup

Deleted 'CRT_REMOVE.TXT'

Viz také

Zpracování souborů
_unlink, _wunlink