_unlink, _wunlink

刪除檔案。

語法

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

參數

filename
要移除之檔案的名稱。

傳回值

如果成功，所有這些函式都會傳回 0。 否則，函式會傳回 -1 並將 設定 errno 為 EACCES，這表示路徑會指定唯讀檔案或目錄，或設定為 ENOENT，這表示找不到檔案或路徑。

如需傳回碼的詳細資訊，請參閱errno、 _doserrno_sys_errlist和 _sys_nerr。

備註

_unlink 函式會刪除 filename 所指定的檔案。 _wunlink 是寬字元版本的 _unlink； filename 的 _wunlink 引數是寬字元字串。 除此之外，這些函式的行為相同。

根據預設，此函式的全域狀態會限定於應用程式。 若要變更此行為，請參閱 CRT 中的全域狀態。

一般文字常式對應

TCHAR.H 常式	_UNICODE 和 _MBCS 未定義	_MBCS 已定義	_UNICODE 已定義
_tunlink	_unlink	_unlink	_wunlink

需求

常式	必要的標頭
_unlink	<io.h> 和 <stdio.h>
_wunlink	<io.h> 或 <wchar.h>

如需相容性詳細資訊，請參閱相容性。

程式碼範例

此程式會使用 _unlink 來刪除 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.txt

This file will be deleted.

範例輸出

Deleted 'CRT_UNLINK.TXT'

另請參閱

檔案處理
_close
remove, _wremove