_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 的宽字符版本；_wunlink 的 filename 参数是宽字符字符串。 否则这些函数具有相同行为。

一般文本例程映射

TCHAR.H 例程	_UNICODE & _MBCS 未定义	已定义 _MBCS	已定义 _UNICODE
_tunlink	_unlink	_unlink	_wunlink

要求

例程	必需的标头
_unlink	<io.h> and <stdio.h>
_wunlink	<io.h> or <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.

示例输出

Deleted 'CRT_UNLINK.TXT'

.NET Framework 等效项

System::IO::File::删除

请参见

参考

文件处理

_close

remove、_wremove