remove、_wremove

[アーティクル]
08/09/2011

ファイルを削除します。

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

パラメーター

path
削除するファイルのパス。

戻り値

ファイルが正常に削除されると 0 を返します。それ以外の場合は -1 を返し、変数 errno に EACCES または ENOENT を設定します。EACCES は、読み取り専用ファイルのパスが指定されているか、指定したファイルが開いていることを示します。ENOENT は、ファイル名またはパスが見つからないか、ディレクトリのパスが指定されていることを示します。

戻り値の詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。

解説

remove 関数は、path で指定されたファイルを削除します。_wremove は、_remove のワイド文字バージョンです。_wremove の path 引数は、ワイド文字列です。それ以外では、_wremove と _remove の動作は同じです。ファイルが削除される前に、そのファイルへのハンドルをすべて閉じる必要があります。

汎用テキストルーチンのマップ

TCHAR.H のルーチン	_UNICODE および _MBCS が未定義の場合	_MBCS が定義されている場合	_UNICODE が定義されている場合
_tremove	remove	remove	_wremove

必要条件

ルーチン	必須ヘッダー
remove	<stdio.h> または <io.h>
_wremove	<stdio.h> または <wchar.h>

互換性の詳細については、「C ランタイムライブラリ」の「互換性」を参照してください。

ライブラリ

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'

同等の .NET Framework 関数

System::IO::File::Delete

参照

ファイル処理

_unlink、_wunlink

次の方法で共有