Stream.write()

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

▼ Stream

  Stream

  Stream.available()

  Stream.availableForWrite()

  Stream.find()

  Stream.findUntil()

  Stream.flush()

  Stream.getTimeout()

  Stream.parseFloat()

  Stream.parseInt()

  Stream.peek()

  Stream.print()

  Stream.println()

  Stream.read()

  Stream.readBytes()

  Stream.readBytesUntil()

  Stream.readString()

  Stream.readStringUntil()

  Stream.setTimeout()

  Stream.write()