File.peek()

Descripción

Devuelve el siguiente byte (carácter) del archivo, sin avanzar al siguiente. Es decir, las llamadas sucesivas a peek() devolverán el mismo carácter, al igual que la próxima llamada a File.read().

El valor recuperado es relativo a la posición del "cursor".

Sintaxis

File archivo = SD.open("archivo.txt", FILE_WRITE);
archivo.peek();

Retorno

El valor recuperado, o -1 si no hay datos para leer (int). Esto último puede deberse a que se alcanzó el final del archivo, porque está cerrado o porque no fue abierto para lectura.

Advertencias

• Si por error no se verifica de antemano si hay datos disponibles, peek() retornará 255 para byte en el caso que el valor real sea -1 (nada).
• Esta función siempre fallará si la instancia representa un directorio o carpeta.

Ejemplo

// Pendiente de hacer
void setup() {
}
void loop() {
}

Vea también

▼ Libreria SD

  File.available()

  File.close()

  File.flush()

  File.isDirectory()

  File.name()

  File.openNextFile()

  File.peek()

  File.position()

  File.print()

  File.println()

  File.read()

  File.rewindDirectory()

  File.seek()

  File.size()

  File.write()

  SD

  SD.begin()

  SD.end()

  SD.exists()

  SD.mkdir()

  SD.open()

  SD.remove()

  SD.rmdir()