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;参数path_wremove为宽字符字符串。 除此以外,_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