_unlink, _wunlink_unlink, _wunlink

Elimine un archivo.Delete a file.

SintaxisSyntax

int _unlink(
   const char *filename
);
int _wunlink(
   const wchar_t *filename
);

ParámetrosParameters

filenamefilename
Nombre del archivo que se va a quitar.Name of file to remove.

Valor devueltoReturn Value

Cada una de estas funciones devuelve 0 si se realiza correctamente.Each of these functions returns 0 if successful. De lo contrario, la función devuelve-1 y establece errno en EACCES, lo que significa que la ruta de acceso especifica un archivo de solo lectura o un directorio, o ENOENT, lo que significa que no se encuentra el archivo o la ruta de acceso.Otherwise, the function returns -1 and sets errno to EACCES, which means the path specifies a read-only file or a directory, or to ENOENT, which means the file or path is not found.

Consulte _doserrno, errno, _sys_errlist y _sys_nerr para obtener más información sobre estos y otros códigos de retorno.See _doserrno, errno, _sys_errlist, and _sys_nerr for more information on these, and other, return codes.

ObservacionesRemarks

La función _unlink elimina el archivo especificado por filename.The _unlink function deletes the file specified by filename. _wunlink es una versión con caracteres anchos de _unlink; el argumento filename para _wunlink es una cadena de caracteres anchos._wunlink is a wide-character version of _unlink; the filename argument to _wunlink is a wide-character string. Por lo demás, estas funciones se comportan exactamente igual.These functions behave identically otherwise.

De forma predeterminada, el ámbito de este estado global de esta función es la aplicación.By default, this function's global state is scoped to the application. Para cambiar esto, vea estado global en CRT.To change this, see Global state in the CRT.

Asignaciones de rutina de texto genéricoGeneric-Text Routine Mappings

Rutina TCHAR.HTCHAR.H routine _UNICODE y _MBCS no definidos_UNICODE & _MBCS not defined _MBCS definido_MBCS defined _UNICODE definido_UNICODE defined
_tunlink_tunlink _unlink_unlink _unlink_unlink _wunlink_wunlink

RequisitosRequirements

RutinaRoutine Encabezado necesarioRequired header
_unlink_unlink <io.h> y <stdio.h><io.h> and <stdio.h>
_wunlink_wunlink <io.h> o <wchar.h><io.h> or <wchar.h>

Para obtener información adicional sobre compatibilidad, consulte Compatibilidad.For additional compatibility information, see Compatibility.

Ejemplo de códigoCode Example

Este programa usa _unlink para eliminar CRT_UNLINK.TXT.This program uses _unlink to delete 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.txtInput: crt_unlink.txt

This file will be deleted.

Salida de ejemploSample Output

Deleted 'CRT_UNLINK.TXT'

Consulta tambiénSee also

Control de archivosFile Handling
_close_close
remove, _wremoveremove, _wremove