remove、_wremoveremove, _wremove

ファイルを削除します。Delete a file.

構文Syntax

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

パラメーターParameters

pathpath
削除されるファイルのパス。Path of file to be removed.

戻り値Return Value

ファイルが正常に削除された場合、これらの関数はそれぞれ 0 を返します。Each of these functions returns 0 if the file is successfully deleted. それ以外の場合は、-1 を返し、 errnoEACCES に設定して、パスが読み取り専用ファイルを指定しているか、ディレクトリを指定しているか、ファイルが開いていることを示します。または、ファイル名またはパスが見つからなかったことを示すために ENOENT を設定します。Otherwise, it returns -1 and sets errno either to EACCES to indicate that the path specifies a read-only file, specifies a directory, or the file is open, or to ENOENT to indicate that the filename or path was not found.

これらのリターンコードの詳細については、「 _doserrno、errno、_sys_errlist、および _sys_nerr 」を参照してください。See _doserrno, errno, _sys_errlist, and _sys_nerr for more information on these and other return codes.

解説Remarks

remove 関数は、path によって指定されたファイルを削除します。The remove function deletes the file specified by path. _wremove_remove のワイド文字バージョンです。_wremoveパス 引数は、ワイド文字列です。_wremove is a wide-character version of _remove; the path argument to _wremove is a wide-character string. _wremove_remove は同じように動作します。_wremove and _remove behave identically otherwise. ファイルを削除する前に、ファイルへのすべてのハンドルを閉じる必要があります。All handles to a file must be closed before it can be deleted.

既定では、この関数のグローバル状態はアプリケーションにスコープが設定されています。By default, this function's global state is scoped to the application. これを変更するには、「 CRT でのグローバル状態」を参照してください。To change this, see Global state in the CRT.

汎用テキスト ルーチンのマップGeneric-Text Routine Mappings

TCHAR.H のルーチンTCHAR.H routine _UNICODE および _MBCS が未定義の場合_UNICODE & _MBCS not defined _MBCS が定義されている場合_MBCS defined _UNICODE が定義されている場合_UNICODE defined
_tremove_tremove removeremove removeremove _wremove_wremove

必要条件Requirements

ルーチンによって返される値Routine 必須ヘッダーRequired header
removeremove <stdio.h> または <io.h><stdio.h> or <io.h>
_wremove_wremove <stdio.h> または <wchar.h><stdio.h> or <wchar.h>

互換性の詳細については、「互換性」を参照してください。For additional compatibility information, see Compatibility.

ライブラリLibraries

C ランタイム ライブラリのすべてのバージョン。All versions of the C run-time libraries.

Example

// 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.txtInput: crt_remove.txt

This file will be deleted.

出力例Sample Output

Deleted 'CRT_REMOVE.TXT'

関連項目See also

ファイルの処理File Handling
_unlink、_wunlink_unlink, _wunlink