_unlink, _wunlink
Удаление файла.
int _unlink(
const char *filename
);
int _wunlink(
const wchar_t *filename
);
Параметры
- filename
Имя файла для удаления.
Возвращаемое значение
Каждая из этих функций возвращает 0 в случае успеха. В противном случае функция возвращает -1 и устанавливает errno в значение EACCES, означающее, что путь указывает на файл, доступный только для чтения, или в значение ENOENT, означающее, что такой файл или путь не удалось найти, или путь указывает на каталог.
Дополнительные сведения об этих и других кодах ошибок см. в разделе _doserrno, errno, _sys_errlist и _sys_nerr.
Заметки
Функция _unlink удаляет файл, указанный в filename. _wunlink — двухбайтовая версия _unlink; аргумент filename для _wunlink - строка двухбайтовых знаков. В остальном эти функции ведут себя идентично.
Универсальное текстовое сопоставление функций
Подпрограмма TCHAR.H |
_UNICODE & _MBCS не определены |
_MBCS определено |
_UNICODE определено |
|---|---|---|---|
_tunlink |
_unlink |
_unlink |
_wunlink |
Требования
Подпрограмма |
Обязательный заголовок |
|---|---|
_unlink |
<io.h> и <stdio.h> |
_wunlink |
<io.h> или <wchar.h> |
Дополнительные сведения о совместимости см. в разделе Совместимость во введении.
Пример кода
Эта программа использует _unlink для удаления 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" );
}
Input: crt_unlink.txt
This file will be deleted.
Sample Output
Deleted 'CRT_UNLINK.TXT'