Diferencia entre revisiones de «Stream.write()»
De ArduWiki
(→Vea también) |
|||
| Línea 1: | Línea 1: | ||
== Descripción == | == Descripción == | ||
| + | Envia datos binarios ("crudos") al flujo de salida. Esta información se envía como un byte o serie de bytes. | ||
== Sintaxis == | == Sintaxis == | ||
<pre> | <pre> | ||
| + | objetoStream.write(val); | ||
| + | objetoStream.write(str); | ||
| + | objetoStream.write(buf, len); | ||
</pre> | </pre> | ||
== Parametros == | == Parametros == | ||
| + | ;val: Valor como un solo [[byte]] o variable (el byte menos signficativo en caso de ser más grande). | ||
| + | ;str: Cadena como una serie de bytes ([[string]]). | ||
| + | ;buf: Matriz enviada como una serie de bytes ([[byte]]*). | ||
| + | ;len: Largo de la cadena ([[int]]). | ||
| − | == | + | == Retorno == |
| + | La cantidad real de bytes que se enviaron con éxito ([[int]]). | ||
== Advertencias == | == Advertencias == | ||
| − | + | * Para enviar los caracteres que representan los dígitos de un número, use la función [[Stream.print()]] en su lugar. | |
| + | * 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'''. En este caso, solo se debe implementar la versión de un sólo byte ('''objetoStream.write(val)'''); y debe retornar '''1''' ([[true / false|true]]) si se pudo transmitir el dato, '''0''' ([[true / false|false]]) en caso contrario. Si la clase no posee o soporta flujos de salida, simplemente debe retornar '''0''' ([[true / false|false]]) para que las operaciones de este tipo no se puedan realizar. | ||
== Ejemplo == | == Ejemplo == | ||
<syntaxhighlight lang="c++"> | <syntaxhighlight lang="c++"> | ||
| + | while (archivo.available()) { | ||
| + | Serial.write(archivo.read()); // Vuelca el contenido "crudo" o binario del archivo, al puerto serial | ||
| + | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Revisión del 15:29 11 jul 2018
Contenido
Descripción
Envia datos binarios ("crudos") al flujo de salida. Esta información se envía como un byte o serie de bytes.
Sintaxis
objetoStream.write(val); objetoStream.write(str); objetoStream.write(buf, len);
Parametros
- val
- Valor como un solo byte o variable (el byte menos signficativo en caso de ser más grande).
- str
- Cadena como una serie de bytes (string).
- buf
- Matriz enviada como una serie de bytes (byte*).
- len
- Largo de la cadena (int).
Retorno
La cantidad real de bytes que se enviaron con éxito (int).
Advertencias
- Para enviar los caracteres que representan los dígitos de un número, use la función Stream.print() en su lugar.
- 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. En este caso, solo se debe implementar la versión de un sólo byte (objetoStream.write(val)); y debe retornar 1 (true) si se pudo transmitir el dato, 0 (false) en caso contrario. Si la clase no posee o soporta flujos de salida, simplemente debe retornar 0 (false) para que las operaciones de este tipo no se puedan realizar.
Ejemplo
while (archivo.available()) {
Serial.write(archivo.read()); // Vuelca el contenido "crudo" o binario del archivo, al puerto serial
}
