remove
| Types and objects | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Definido en el encabezado
<stdio.h>
|
||
|
int
remove
(
const
char
*
pathname
)
;
|
||
Elimina el archivo identificado por la cadena de caracteres apuntada por pathname .
Si el archivo está actualmente abierto por cualquier proceso, el comportamiento de esta función está definido por la implementación. Los sistemas POSIX desvinculan el nombre del archivo (entrada de directorio), pero el espacio del sistema de archivos utilizado por el archivo no se recupera mientras esté abierto en cualquier proceso y mientras existan otros enlaces físicos al archivo. Windows no permite eliminar el archivo en tales casos.
Contenidos |
Parámetros
| pathname | - | puntero a una cadena terminada en nulo que contiene la ruta que identifica el archivo a eliminar |
Valor de retorno
0 en caso de éxito o valor distinto de cero en caso de error.
Notas
POSIX especifica muchos detalles adicionales para el comportamiento de esta función.
Ejemplo
#include <stdio.h> #include <stdlib.h> int main(void) { FILE* fp = fopen("file1.txt", "w"); // crear archivo if (!fp) { perror("file1.txt"); return EXIT_FAILURE; } puts("Created file1.txt"); fclose(fp); int rc = remove("file1.txt"); if (rc) { perror("remove"); return EXIT_FAILURE; } puts("Removed file1.txt"); fp = fopen("file1.txt", "r"); // Fallo: el archivo no existe if (!fp) perror("Opening removed file failed"); rc = remove("file1.txt"); // Fallo: el archivo no existe if (rc) perror("Double-remove failed"); return EXIT_SUCCESS; }
Salida posible:
Created file1.txt Removed file1.txt Opening removed file failed: No such file or directory Double-remove failed: No such file or directory
Referencias
- Estándar C23 (ISO/IEC 9899:2024):
-
- 7.21.4.1 La función remove (p: TBD)
- Estándar C17 (ISO/IEC 9899:2018):
-
- 7.21.4.1 La función remove (p: TBD)
- Estándar C11 (ISO/IEC 9899:2011):
-
- 7.21.4.1 La función remove (p: 302)
- Estándar C99 (ISO/IEC 9899:1999):
-
- 7.19.4.1 La función remove (p: 268)
- Estándar C89/C90 (ISO/IEC 9899:1990):
-
- 4.9.4.1 La función remove
Véase también
|
renombra un archivo
(función) |
|
|
C++ documentation
para
remove
|
|