remove，_wremove

删除文件。

语法

int remove(
   const char *path
);
int _wremove(
   const wchar_t *path
);

参数

path
要移除的文件的路径。

返回值

如果成功删除文件，则这些函数将返回 0。 否则，它会返回 -1，并将 errno 设置为 EACCES 以表示该路径指定某个只读文件、指定某个目录或该档案已打开，或者，设置为 ENOENT，以指示未找到文件名或路径。

有关返回代码的详细信息，请参阅 errno、_doserrno、_sys_errlist 和 _sys_nerr。

备注

remove 函数将删除 path 指定的文件。_wremove 是 _remove 的宽字符版本；_wremove 的 path 参数是宽字符字符串。 除此以外，_wremove 和 _remove 的行为完全相同。 必须先结束对文件的所有处理，然后才能删除文件。

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。

一般文本例程映射

TCHAR.H 例程	_UNICODE 和 _MBCS 未定义	_MBCS 已定义	_UNICODE 已定义
_tremove	remove	remove	_wremove

要求

例程	必需的标头
remove	<stdio.h> 或 <io.h>
_wremove	<stdio.h> 或 <wchar.h>

有关兼容性的详细信息，请参阅 兼容性。

库

C 运行时库的所有版本。

示例

// crt_remove.c
/* This program uses remove to delete crt_remove.txt */

#include <stdio.h>

int main( void )
{
   if( remove( "crt_remove.txt" ) == -1 )
      perror( "Could not delete 'CRT_REMOVE.TXT'" );
   else
      printf( "Deleted 'CRT_REMOVE.TXT'\n" );
}

输入：crt_remove.txt

This file will be deleted.

示例输出

Deleted 'CRT_REMOVE.TXT'

另请参阅

文件处理
_unlink、_wunlink