_unlink, _wunlink

  • Статья

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

Синтаксис

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

Параметры

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

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

Каждая из этих функций при успешном выполнении возвращает 0. В противном случае функция возвращает значение -1 и задает errnoEACCESзначение , что означает, что путь указывает файл только для чтения или каталог, а также для 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