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.

RemarksRemarks

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

汎用テキスト ルーチンのマップ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