remove, _wremove

Bir dosyayı silin.

Sözdizimi

int remove(
   const char *path
);
int _wremove(
   const wchar_t *path
);

Parametreler

path
Kaldırılacak dosyanın yolu.

Dönüş değeri

Dosya başarıyla silinirse bu işlevlerin her biri 0 döndürür. Aksi takdirde, -1 döndürür ve yolun salt okunur bir dosya belirttiğini, bir dizin belirttiğini veya dosyanın açık ENOENT olduğunu ya da dosya adının veya yolun bulunamadığını gösterecek şekilde ayarlar.errno EACCES

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

Açıklamalar

remove işlevi tarafından _wremovepathbelirtilen dosyayı siler. öğesinin _removegeniş karakterli bir sürümüdür; path bağımsız değişkeni _wremove geniş karakterli bir dizedir. _wremove ve _remove aksi takdirde aynı şekilde davran. Bir dosyanın silinebilmesi için önce tüm tanıtıcıların kapatılması gerekir.

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 olağan _UNICODE ve _MBCS tanımlanmadı _MBCS tanımlanan _UNICODE tanımlanan
_tremove remove remove _wremove

Gereksinimler

Yordam Gerekli başlık
remove <stdio.h> veya <io.h>
_wremove <stdio.h> veya <wchar.h>

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Kitaplıklar

C çalışma zamanı kitaplıklarının tüm sürümleri.

Örnek

// crt_remove.c
/* This program uses remove to delete crt_remove.txt */

#include <stdio.h>

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

Girdi: crt_remove.txt

This file will be deleted.

Örnek çıktı

Deleted 'CRT_REMOVE.TXT'

Ayrıca bkz.

Dosya işleme
_unlink, _wunlink