_unlink, _wunlink

파일을 삭제합니다.

구문

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

매개 변수

filename
제거할 파일의 이름입니다.

반환 값

이러한 각 함수는 정상적으로 실행되면 0을 반환합니다. 그렇지 않으면 함수는 -1을 EACCES반환하고 경로 errno 가 읽기 전용 파일 또는 디렉터리를 지정하거나 파일 또는 경로를 찾을 수 없음을 의미합니다ENOENT.

반환 코드에 대한 자세한 내용은 , , 및 를 참조하세요errno._sys_nerr_sys_errlist_doserrno

설명

_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