_unlink，_wunlink

删除文件。

语法

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