Compartir a través de


_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'

Equivalente en .NET Framework

System::IO::File::Delete

Vea también

Referencia

Control de archivos

_close

remove, _wremove