_unlink, _wunlink
Eliminar un archivo.
int _unlink(
const char *filename
);
int _wunlink(
const wchar_t *filename
);
Parámetros
- filename
Nombre del archivo que se va a quitar.
Valor devuelto
Cada una de estas funciones devuelve 0 si correctamente. Si no, la función devuelve – 1 y establece errno a EACCES, que significa que la ruta especifica un archivo de sólo lectura, o a ENOENT, lo que significa que el archivo o la ruta no se encuentra o la ruta de acceso especificada un directorio.
Vea _doserrno, errno, _sys_errlist y _sys_nerr para obtener más información sobre estos y otros códigos de retorno.
Comentarios
La función de _unlink elimina el archivo especificado por filename. _wunlink es una versión con caracteres anchos de _unlink; el argumento filename para _wunlink es una cadena de caracteres anchos. Por lo demás, estas funciones se comportan exactamente igual.
Asignaciones de rutina de texto genérico
Rutina TCHAR.H |
_UNICODE y _MBCS no definidos |
_MBCS definido |
_UNICODE definido |
|---|---|---|---|
_tunlink |
_unlink |
_unlink |
_wunlink |
Requisitos
Rutina |
Encabezado necesario |
|---|---|
_unlink |
<io.h y> stdio.h <> |
_wunlink |
<io.h o> wchar.h <> |
Para obtener información adicional de compatibilidad, vea Compatibilidad en la Introducción.
Ejemplo de código
Este programa utiliza el _unlink para eliminar 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" );
}
Entrada: crt_unlink.txt
This file will be deleted.
Resultados del ejemplo
Deleted 'CRT_UNLINK.TXT'