Serial.readBytes()

Descripción

Lee caracteres desde el búfer del puerto serie, hacia el especificado. La función termina si la longitud determinada se ha leído, o el tiempo de espera (ver Serial.setTimeout()) se ha agotado.

Sintaxis

Serial.readBytes(buffer, largo);

Parámetros

buffer

el buffer/vector/matriz para almacenar los bytes (char* o byte*).

largo

el número de bytes a leer (int).

Retorna

Devuelve el número de caracteres colocados en el búfer (int). Un 0 significa que no se encontró nada durante el tiempo de espera.

Advertencias

• La longitud del buffer debe respetarse, de lo contrario se corre el riesgo de un "desbordamiento de buffer" que puede corromper el contenido la memoria de ejecución (SRAM).

Ejemplo

if (Serial.available()) {
  buffer[Serial.readBytes(buffer, sizeof(buffer) - 1)] = 0; // Colocar el terminador de cadenas de caracteres
  Serial.print(F("Mensaje recuperado: \""));
  Serial.print(buffer);
  Serial.println('\"');
}

Vea también

▼ Serial

  F()

  Serial

  Serial.available()

  Serial.availableForWrite()

  Serial.begin()

  Serial.end()

  Serial.find()

  Serial.findUntil()

  Serial.flush()

  Serial.getTimeout()

  Serial.parseFloat()

  Serial.parseInt()

  Serial.peek()

  Serial.print()

  Serial.println()

  Serial.read()

  Serial.readBytes()

  Serial.readBytesUntil()

  Serial.readString()

  Serial.readStringUntil()

  Serial.setTimeout()

  Serial.write()

  serialAvailable()

  serialEvent()

  sprintf()

  Tabla ASCII