_unlink, _wunlink

Elimine un archivo.

Sintaxis

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 se realiza correctamente. De lo contrario, la función devuelve -1 y establece en errnoEACCES, lo que significa que la ruta de acceso especifica un archivo de solo lectura o un directorio, o en ENOENT, lo que significa que no se encuentra el archivo o la ruta de acceso.

Para obtener más información sobre los códigos de retorno, vea errno, _doserrno, _sys_errlist y _sys_nerr.

Comentarios

La función _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.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Asignaciones de rutinas de texto genérico

Rutina TCHAR.H	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_tunlink	_unlink	_unlink	_wunlink

Requisitos

Routine	Encabezado necesario
_unlink	<io.h> y <stdio.h>
_wunlink	<io.h> o <wchar.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Ejemplo de código

Este programa usa _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.

Salida de ejemplo

Deleted 'CRT_UNLINK.TXT'

Consulte también

Control de archivos
_close
remove, _wremove