_unlink, _wunlink
Menghapus file.
Sintaks
int _unlink(
const char *filename
);
int _wunlink(
const wchar_t *filename
);
Parameter
filename
Nama file yang akan dihapus.
Nilai hasil
Masing-masing fungsi ini mengembalikan 0 jika berhasil. Jika tidak, fungsi mengembalikan -1 dan diatur errno ke EACCES, yang berarti jalur menentukan file baca-saja atau direktori, atau ke ENOENT, yang berarti file atau jalur tidak ditemukan.
Untuk informasi selengkapnya tentang kode pengembalian, lihat errno, , _doserrno_sys_errlist, dan _sys_nerr.
Keterangan
Fungsi _unlink menghapus file yang ditentukan oleh filename. _wunlink adalah versi karakter luas dari _unlink; filename argumen ke _wunlink adalah string karakter lebar. Fungsi-fungsi ini berulah secara identik jika tidak.
Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.
Pemetaan rutin teks generik
| TCHAR. Rutinitas H | _UNICODE dan _MBCS tidak ditentukan |
_MBCS Didefinisikan |
_UNICODE Didefinisikan |
|---|---|---|---|
_tunlink |
_unlink |
_unlink |
_wunlink |
Persyaratan
| Rutin | Header yang diperlukan |
|---|---|
_unlink |
<io.h> dan <stdio.h> |
_wunlink |
<io.h> atau <wchar.h> |
Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.
Contoh kode
Program ini menggunakan _unlink untuk menghapus 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" );
}
Input: crt_unlink.txt
This file will be deleted.
Sampel output
Deleted 'CRT_UNLINK.TXT'