`_unlink`, `_wunlink`

Статья
2023-10-12

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

Синтаксис

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

Параметры

filename
Имя удаляемого файла.

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

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

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

Замечания

Функция _unlink удаляет файл, указанный в параметре filename. _wunlink — это версия _unlinkс расширенными символами; аргумент filename для _wunlink — строка расширенных символов. В остальном эти функции ведут себя одинаково.

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

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

Подпрограмма 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" );
}

Входные данные: crt_unlink.txt

This file will be deleted.

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

Deleted 'CRT_UNLINK.TXT'

См. также

Обработка файлов
_close
remove, _wremove