Diferencia entre revisiones de «SD.remove()»
De ArduWiki
(Página creada con «== Descripción == Elimina el archivo en la ruta dada. == Sintaxis == <pre> SD.remove(ruta); </pre> == Parametros == ;ruta: ruta hacia el archivo que se pretende eliminar...») |
m |
||
Línea 11: | Línea 11: | ||
== Retorna == | == Retorna == | ||
− | '''true''' si se pudo eliminar, '''false''' en caso contrario ([[bool]]). Si falla, es porque el archivo no existe en esa ubicación. | + | '''true''' si se pudo eliminar, '''false''' en caso contrario ([[bool]]). Si falla, es porque el archivo no existe en esa ubicación, o la ruta apunta a un directorio/carpeta. |
== Advertencias == | == Advertencias == | ||
− | Asegúrate de que dicho archivo no esté abierto antes de intentar eliminarlo. | + | * Asegúrate de que dicho archivo no esté abierto antes de intentar eliminarlo. |
+ | * Esta función no puede eliminar carpetas; para eso, usa [[SD.rmdir()]] en su lugar. | ||
== Ejemplo == | == Ejemplo == |
Revisión del 18:16 5 may 2019
Contenido
Descripción
Elimina el archivo en la ruta dada.
Sintaxis
SD.remove(ruta);
Parametros
- ruta
- ruta hacia el archivo que se pretende eliminar, o sólo el nombre para ubicarlo en la "raíz" (string o String).
Retorna
true si se pudo eliminar, false en caso contrario (bool). Si falla, es porque el archivo no existe en esa ubicación, o la ruta apunta a un directorio/carpeta.
Advertencias
- Asegúrate de que dicho archivo no esté abierto antes de intentar eliminarlo.
- Esta función no puede eliminar carpetas; para eso, usa SD.rmdir() en su lugar.
Ejemplo
const char[] nombre = "Borrame.txt";
void setup() {
Serial.begin(9600);
// Inicializamos la tarjeta por supuesto
if (SD.remove(nombre)) {
Serial.print(nombre);
Serial.println(" se ha logrado eliminar.");
} else {
Serial.print(nombre);
Serial.println(" no se puede eliminar porque no existe.");
}
}
void loop() {}