remove、_wremove
更新 : 2007 年 11 月
ファイルを削除します。
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'