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