_unlink、_wunlink
ファイルを削除します。
int _unlink(
const char *filename
);
int _wunlink(
const wchar_t *filename
);
パラメーター
- filename
削除するファイルの名前。
戻り値
これらの関数は正常終了した場合は 0 を返します。そうしないと関数の戻り値は ENOENT(パスを意味する設定 errnoEACCES のとに 1 ファイルまたはパスを意味する読み取り専用ファイルまたは存在しないか指定したディレクトリ パス指定します。
これらの詳細については_doserrnoerrno_sys_errlist と _sys_nerr とそのほかのリターン コード " " を参照してください。
解説
_unlink の関数は filename で指定されたファイルを削除します。_wunlink 関数は、_unlink 関数のワイド文字バージョンです。_wunlink 関数の引数 filename は、ワイド文字列です。それ以外では、これらの関数の動作は同じです。
汎用テキスト ルーチンのマップ
TCHAR.H のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
---|---|---|---|
_tunlink |
_unlink |
_unlink |
_wunlink |
必要条件
ルーチン |
必須ヘッダー |
---|---|
_unlink |
<io.h> および <stdio.h> |
_wunlink |
<io.h> または <wchar.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
コード例
このプログラムは CRT_UNLINK.TXT を削除するには_unlink を使用します。
// 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.txt
This file will be deleted.
出力例
Deleted 'CRT_UNLINK.TXT'