_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