remove, _wremove

Удалите файл.

Синтаксис

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

Параметры

path
Путь к файлу, который требуется удалить.

Возвращаемое значение

Каждая из этих функций возвращает 0, если файл был успешно удален. В противном случае возвращается значение -1 и задает errno значение , указывающее EACCES , что путь указывает файл, доступный только для чтения, указывает каталог или файл открыт или указывает ENOENT , что имя файла или путь не найден.

Дополнительные сведения о кодах возврата см. в разделе errno, _doserrno_sys_errlistи _sys_nerr.

Замечания

Функция remove удаляет файл, pathуказанный в ._wremove, является широкой символьной версией_remove; path аргумент _wremove является строкой с широким символом. Поведение_wremove и _remove идентично в противном случае. Чтобы можно было удалить файл, все дескрипторы файлов должны быть закрыты.

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Сопоставления подпрограмм универсального текста

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

Ввод: crt_remove.txt

This file will be deleted.

Пример полученных результатов

Deleted 'CRT_REMOVE.TXT'

См. также

Обработка файлов
_unlink, _wunlink