%>

删除文件。

语法

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
%>