Diferencia entre revisiones de «Stream.write()»

De ArduWiki
Saltar a: navegación, buscar
(Página creada con «== Descripción == == Sintaxis == <pre> </pre> == Parametros == == Retorna == == Advertencias == Nada. == Ejemplo == <syntaxhighlight lang="c++"> </syntaxhighlight> =...»)
 
(Referencias)
 
(No se muestran 4 ediciones intermedias de 2 usuarios)
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]]).
  
== Retorna ==
+
== Retorno ==
 +
La cantidad real de bytes que se enviaron con éxito ([[int]]).
  
 
== Advertencias ==
 
== Advertencias ==
Nada.
+
* 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>
  
 
== 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:26 6 may 2019

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
}

Vea también


Referencias