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...»)
 
(Vea también)
 
(No se muestran 5 ediciones intermedias de 2 usuarios)
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 ==
 
<syntaxhighlight lang="c++">
 
<syntaxhighlight lang="c++">
 +
#include <SPI.h>
 +
#include <SD.h>
 +
 
const char[] nombre = "Borrame.txt";
 
const char[] nombre = "Borrame.txt";
  
Línea 34: Línea 38:
 
}
 
}
  
void loop() {}
+
void loop() {
 +
  //Nada
 +
}
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
== Vea también ==
 
== Vea también ==
* [[SD]]
+
<categorytree mode=all>Libreria SD</categorytree>
* [[SD.rmdir()]]
 
  
 
== Referencias ==
 
== Referencias ==
 +
 +
 +
[[Category:Libreria SD]]

Revisión actual del 20:39 17 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

#include <SPI.h>
#include <SD.h>

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

Vea también


Referencias