remove, _wremove
Eliminar un archivo.
int remove(
const char *path
);
int _wremove(
const wchar_t *path
);
Parámetros
- ruta de acceso
Ruta de acceso del archivo que se va a quitar.
Valor devuelto
Cada una de estas funciones devuelve 0 si se elimina correctamente. De lo contrario, devuelve -1 y establece errno cualquier a EACCES para indicar que la ruta especifica un archivo de sólo lectura o el archivo abierto, o a ENOENT para indicar que el nombre de archivo o ruta no se encontró o que la ruta especifica 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 quitar elimina el archivo especificado por la *ruta. *_wremove es una versión con caracteres anchos de _remove; el argumento de la ruta de acceso a _wremove es una cadena de caracteres. _wremove y _remove se comportan exactamente igual de otra manera. Todos los identificadores en un archivo deben cerrarse antes de poder eliminar.
Asignaciones de rutina de texto genérico
Rutina TCHAR.H |
_UNICODE y _MBCS no definidos |
_MBCS definido |
_UNICODE definido |
---|---|---|---|
_tremove |
remove |
remove |
_wremove |
Requisitos
Rutina |
Encabezado necesario |
---|---|
remove |
<stdio.h o> io.h <> |
_wremove |
<stdio.h> o <wchar.h> |
Para obtener información adicional de compatibilidad, vea Compatibilidad en la Introducción.
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.
Resultados del ejemplo
Deleted 'CRT_REMOVE.TXT'