_unlink, _wunlink

Bir dosyayı silin.

Sözdizimi

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

Parametreler

filename
Kaldırılacak dosyanın adı.

Dönüş değeri

Bu işlevlerin her biri başarılı olursa 0 döndürür. Aksi takdirde, işlev -1 döndürür ve olarak ayarlar errno EACCES. Bu, yolun salt okunur bir dosya veya dizin ya da ENOENTolarak belirtildiği anlamına gelir. Bu, dosya veya yolun bulunamadığını gösterir.

İade kodları hakkında daha fazla bilgi için bkz. errno, _doserrno, _sys_errlistve _sys_nerr.

Açıklamalar

_unlink işlevi tarafından filenamebelirtilen dosyayı siler. _wunlink , öğesinin _unlinkgeniş karakterli bir sürümüdür; filename bağımsız değişkeni _wunlink geniş karakterli bir dizedir. Bu işlevler aynı şekilde davranır.

Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı değiştirmek için bkz. CRT'de Genel durum.

Genel metin yordamı eşlemeleri

TCHAR.H yordamı	_UNICODE ve _MBCS tanımlanmadı	_MBCS tanımlanan	_UNICODE tanımlanan
_tunlink	_unlink	_unlink	_wunlink

Gereksinimler

Yordam	Gerekli başlık
_unlink	<io.h> ve <stdio.h>
_wunlink	<io.h> veya <wchar.h>

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Kod örneği

Bu program CRT_UNLINK.TXT silmek için _unlink kullanır.

// 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" );
}

Giriş: crt_unlink.txt

This file will be deleted.

Örnek çıktı

Deleted 'CRT_UNLINK.TXT'

Ayrıca bkz.

Dosya işleme
_close
remove, _wremove