Diferencia entre revisiones de «Stream.read()»
De ArduWiki
(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 == | ||
| − | + | <categorytree mode=all>Stream</categorytree> | |
| − | |||
| − | |||
| − | |||
== Referencias == | == Referencias == | ||
| − | [[Category: | + | [[Category:Stream]] |
Revisión actual del 14:24 6 may 2019
Contenido
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
