remove, _wremove

Elimine un archivo.

Sintaxis

int remove(
   const char *path
);
int _wremove(
   const wchar_t *path
);

Parámetros

path
Ruta de acceso del archivo que se va a quitar.

Valor devuelto

Cada una de estas funciones devuelve 0 si el archivo se elimina correctamente. De lo contrario, devuelve -1 y establece errno en EACCES para indicar que la ruta de acceso especifica un archivo de solo lectura, que especifica un directorio o que el archivo está abierto, o bien en ENOENT para indicar que no se encontró el nombre de 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 remove función elimina el archivo especificado porpath . _wremove es una versión de caracteres anchos de _remove; el path argumento a _wremove es una cadena de caracteres anchos. Por lo demás,_wremove y _remove se comportan de forma idéntica. Para poder eliminar un archivo, primero se deben cerrar todos los controladores correspondientes.

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
_tremove	remove	remove	_wremove

Requisitos

Routine	Encabezado necesario
remove	<stdio.h> o <io.h>
_wremove	<stdio.h> o <wchar.h>

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

Bibliotecas

Todas las versiones de las bibliotecas en tiempo de ejecución de C.

Ejemplo

// crt_remove.c
/* This program uses remove to delete crt_remove.txt */

#include <stdio.h>

int main( void )
{
   if( remove( "crt_remove.txt" ) == -1 )
      perror( "Could not delete 'CRT_REMOVE.TXT'" );
   else
      printf( "Deleted 'CRT_REMOVE.TXT'\n" );
}

Entrada: crt_remove.txt

This file will be deleted.

Salida de ejemplo

Deleted 'CRT_REMOVE.TXT'

Consulte también

Control de archivos
_unlink, _wunlink