Diferencia entre revisiones de «SD.remove()»

De ArduWiki
Saltar a: navegación, buscar
(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 14:16 5 may 2019

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() {}

Vea también

Referencias