Diferencia entre revisiones de «Stream.read()»

De ArduWiki
Saltar a: navegación, buscar
(Página creada con «== Descripción == == Sintaxis == <pre> </pre> == Parametros == == Vea también == * Stream.flush() * Stream.find() * Stream.findUntil() * Stream.peek()...»)
 
(Referencias)
 
(No se muestran 4 ediciones intermedias de 2 usuarios)
Línea 1: Línea 1:
 
== Descripción ==
 
== Descripción ==
 +
Lee un byte/caracter proveniente del flujo de entrada; y lo "consume" (flujos byte a byte) o provoca avanzar al siguiente (flujos por bloques).
  
 
== Sintaxis ==
 
== Sintaxis ==
 
<pre>
 
<pre>
 +
objetoStream.read()
 
</pre>
 
</pre>
  
 
== Parametros ==
 
== Parametros ==
 +
Nada.
 +
 +
== Retorno ==
 +
El valor recuperado, o -1 si no hay datos para leer ([[int]]).
 +
 +
== 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).
 +
* Cualquier clase que herede de [[Stream]], debe implementar obligatoria y explícitamente esta función. Debe hacerse de manera que cumpla lo descrito en la sección de '''Descripción''' y '''Retorno'''.
 +
 +
== Ejemplo ==
 +
<syntaxhighlight lang="c++">
 +
void loop(){
 +
  if (Serial.available()){
 +
      byte car = Serial.read();    //Lee caracter enviado y borra del buffer
 +
      Serial.write(car);          //Imprime caracter enviado
 +
      Serial.println(car);        //Impime codigo ASCII caracter enviado
 +
  }
 +
}
 +
</syntaxhighlight>
  
 
== Vea también ==
 
== Vea también ==
* [[Stream.flush()]]
+
<categorytree mode=all>Stream</categorytree>
* [[Stream.find()]]
 
* [[Stream.findUntil()]]
 
* [[Stream.peek()]]
 
  
 
== Referencias ==
 
== Referencias ==
  
[[Category:Funciones]]
+
[[Category:Stream]]

Revisión actual del 18:24 6 may 2019

Descripción

Lee un byte/caracter proveniente del flujo de entrada; y lo "consume" (flujos byte a byte) o provoca avanzar al siguiente (flujos por bloques).

Sintaxis

objetoStream.read()

Parametros

Nada.

Retorno

El valor recuperado, o -1 si no hay datos para leer (int).

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).
  • Cualquier clase que herede de Stream, debe implementar obligatoria y explícitamente esta función. Debe hacerse de manera que cumpla lo descrito en la sección de Descripción y Retorno.

Ejemplo

void loop(){
   if (Serial.available()){
      byte car = Serial.read();    //Lee caracter enviado y borra del buffer
      Serial.write(car);           //Imprime caracter enviado
      Serial.println(car);         //Impime codigo ASCII caracter enviado
   }
}

Vea también


Referencias