_unlink、_wunlink_unlink, _wunlink

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

構文Syntax

int _unlink(
   const char *filename
);
int _wunlink(
   const wchar_t *filename
);

パラメーターParameters

ファイル名filename
削除するファイルの名前。Name of file to remove.

戻り値Return Value

正常に終了した場合、これらの各関数は 0 を返します。Each of these functions returns 0 if successful. それ以外の場合、この関数は-1 を返し、 errnoEACCESに設定します。これは、パスが読み取り専用のファイルまたはディレクトリを指定しているか、ファイルまたはパスが見つからないことを示すENOENTに設定されていることを意味します。Otherwise, the function returns -1 and sets errno to EACCES, which means the path specifies a read-only file or a directory, or to ENOENT, which means the file or path is 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

Unlink関数は、 filenameによって指定されたファイルを削除します。The _unlink function deletes the file specified by filename. _wunlinkのワイド文字バージョンです。 _wunlinkfilename引数はワイド文字列です。_wunlink is a wide-character version of _unlink; the filename argument to _wunlink is a wide-character string. それ以外では、これらの関数の動作は同じです。These functions behave identically otherwise.

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

TCHAR.H のルーチンTCHAR.H routine _UNICODE および _MBCS が未定義の場合_UNICODE & _MBCS not defined _MBCS が定義されている場合_MBCS defined _UNICODE が定義されている場合_UNICODE defined
tunlink (_c)_tunlink _unlink_unlink _unlink_unlink _wunlink_wunlink

必要条件Requirements

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

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

コード例Code Example

このプログラムは、_unlink を使用して CRT_UNLINK.TXT を削除します。This program uses _unlink to delete CRT_UNLINK.TXT.

// crt_unlink.c

#include <stdio.h>

int main( void )
{
   if( _unlink( "crt_unlink.txt" ) == -1 )
      perror( "Could not delete 'CRT_UNLINK.TXT'" );
   else
      printf( "Deleted 'CRT_UNLINK.TXT'\n" );
}

入力: crt_unlink.txtInput: crt_unlink.txt

This file will be deleted.

出力例Sample Output

Deleted 'CRT_UNLINK.TXT'

関連項目See also

ファイル処理File Handling
_close_close
remove、_wremoveremove, _wremove