Ver el código de «File.read()»

== Descripción ==
Lee un byte/caracter del archivo, y además avanza al siguiente. El valor recuperado es relativo a la [[File.position()|posición del "cursor"]].

== Sintaxis ==
<pre>
File archivo = SD.open("archivo.txt", FILE_WRITE);
archivo.read()
archivo.read(buffer, tamanio);
</pre>

== Parametros ==
;buffer: una matriz de cualquier tipo, aunque usualmente de tipo [[byte]] o [[char]] (en la implementación se declara como puntero de tipo [[void]]).
;tamanio: el tamaño de dicha matriz '''en bytes'''. ([[unsigned int]]).

== Retorno ==
* Para la primera, 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.
* Para la segunda, la cantidad de bytes leídos exitosamente ([[unsigned int]]). Si retorna cero, es porque no logró leer nada.

== Advertencias ==
* Si por error no se verifica de antemano si hay datos disponibles, '''read()''' 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.

== Comentarios ==
A pesar de que la segunda sintaxis hace lo mismo que [[Stream.readBytes()|readBytes()]] (y que además se puede utilizar con normalidad), se recomienda la aquí mencionada debido a que es más eficiente para la obtención de múltiples bytes que su contraparte "genérica".

== Ejemplo ==
<syntaxhighlight lang="c++">
void setup(){
   Serial.begin(9600);
   // Tarjeta inicializada y archivo abierto para lectura
   File archivo = SD.open("archivo.txt", FILE_WRITE);
   int dato;
   while ((dato = archivo.read()) >= 0){
      Serial.write(dato);           //Imprime caracter leído
   }
   archivo.close();
}
void loop(){
   //Nada
}
</syntaxhighlight>

== Vea también ==
<categorytree mode=all>Libreria SD</categorytree>

== Referencias ==
[[Category:Libreria SD]]