remove, _wremove

Menghapus file.

Sintaks

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

Parameter

path
Jalur file yang akan dihapus.

Nilai hasil

Masing-masing fungsi ini mengembalikan 0 jika file berhasil dihapus. Jika tidak, ia mengembalikan -1 dan mengatur errno ke untuk EACCES menunjukkan bahwa jalur menentukan file baca-saja, menentukan direktori, atau file terbuka, atau untuk ENOENT menunjukkan bahwa nama file atau jalur tidak ditemukan.

Untuk informasi selengkapnya tentang kode pengembalian, lihat errno, , _doserrno_sys_errlist, dan _sys_nerr.

Keterangan

Fungsi remove menghapus file yang ditentukan oleh path. _wremove adalah versi _removekarakter lebar ; path argumen ke _wremove adalah string karakter lebar. _wremove dan _remove berulah secara identik jika tidak. Semua handel ke file harus ditutup sebelum dapat dihapus.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Pemetaan rutin teks generik

TCHAR.H Rutin	_UNICODE dan _MBCS tidak ditentukan	_MBCS Didefinisikan	_UNICODE Didefinisikan
_tremove	remove	remove	_wremove

Persyaratan

Rutin	Header yang diperlukan
remove	<stdio.h> atau <io.h>
_wremove	<stdio.h> atau <wchar.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Pustaka

Semua versi pustaka run-time C.

Contoh

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

Masukan: crt_remove.txt

This file will be deleted.

Sampel output

Deleted 'CRT_REMOVE.TXT'

Lihat juga

Penanganan file
_unlink, _wunlink