Diferencia entre revisiones de «Serial.readString()»

De ArduWiki
Saltar a: navegación, buscar
(Referencias)
 
(No se muestran 9 ediciones intermedias de 2 usuarios)
Línea 1: Línea 1:
 
== Descripción ==
 
== Descripción ==
lee los caracteres del buffer serie en una cadena. La función se anula si el tiempo de espera se ha alcanzado (ver [[setTimeout()]]).
+
Lee caracteres y los coloca en un [[String]]. La función finaliza cuando el tiempo de espera (ver [[Serial.setTimeout()]]) se ha agotado.
 
 
Esta función es parte de la clase [[Stream]] y es llamada por cualquier clase que herede de ella ([[Wire]], [[Serial]], etc.).
 
  
 
== Sintaxis ==
 
== Sintaxis ==
Línea 10: Línea 8:
  
 
== Retorna ==
 
== Retorna ==
Una cadena leída del buffer serie.
+
El objeto [[String]] resultante de la lectura.
  
 
== Advertencias ==
 
== Advertencias ==
Nada.
+
* Hay un "bug" o fallo con esta función: si el flujo de entrada es constante (tiempo de espera nunca se agota), se corre el riesgo de colgar completamente el programa. La razón se debe a que, conceptualmente, [[String]] es ilimitado en tamaño; pero como la [[SRAM]] no es así, eventualmente el programa llegará a colapsar.
 +
 
 +
== Ejemplo 1 ==
 +
Envíe por la consola un mensaje corto. Por ejemplo "Hola mundo"
  
== Ejemplo ==
 
 
<syntaxhighlight lang="c++">
 
<syntaxhighlight lang="c++">
 +
void setup(){
 +
  Serial.begin(9600);
 +
}
 +
void loop(){
 +
  if (Serial.available()) {
 +
      Serial.print("Mensaje recuperado: \"");
 +
      Serial.print(Serial.readString());
 +
      Serial.println('\"');
 +
  }
 +
}
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 +
== Ejemplo 2 ==
 +
Envíe por la consola un mensaje corto. Por ejemplo "Hola mundo"
 +
 +
<syntaxhighlight lang="c++">
 +
void setup(){
 +
  Serial.begin(9600);
 +
}
 +
void loop(){
 +
  if (Serial.available()) {
 +
      string texto = Serial.print(Serial.readString();
 +
      Serial.println(texto.lenght());
 +
  }
 +
}
 +
</syntaxhighlight>
 +
 +
== Ejemplo 3 ==
 +
En este ejemplo debes enviar una frase por la consola por ejemplo "Apuntes de Arduino".
 +
 +
<syntaxhighlight lang="c++">
 +
void setup(){
 +
  Serial.begin(9600);
 +
}
 +
void loop(){
 +
  if (Serial.available()) {
 +
    String texto = Serial.readString();
 +
    Serial.println(texto.length());
 +
  }
 +
}</syntaxhighlight>
  
 
== Vea también ==
 
== Vea también ==
* [[Serial.begin()]]
+
<categorytree mode=all>Serial</categorytree>
* [[Serial.available()]]
 
* [[Serial.print()]]
 
* [[Serial.end()]]
 
  
 
== Referencias ==
 
== Referencias ==
  
[[Category:Funciones]]
+
[[Category:Serial]]

Revisión actual del 13:49 6 may 2019

Descripción

Lee caracteres y los coloca en un String. La función finaliza cuando el tiempo de espera (ver Serial.setTimeout()) se ha agotado.

Sintaxis

Serial.readString();

Retorna

El objeto String resultante de la lectura.

Advertencias

  • Hay un "bug" o fallo con esta función: si el flujo de entrada es constante (tiempo de espera nunca se agota), se corre el riesgo de colgar completamente el programa. La razón se debe a que, conceptualmente, String es ilimitado en tamaño; pero como la SRAM no es así, eventualmente el programa llegará a colapsar.

Ejemplo 1

Envíe por la consola un mensaje corto. Por ejemplo "Hola mundo"

void setup(){
   Serial.begin(9600);
}
void loop(){
   if (Serial.available()) {
      Serial.print("Mensaje recuperado: \"");
      Serial.print(Serial.readString());
      Serial.println('\"');
   }
}

Ejemplo 2

Envíe por la consola un mensaje corto. Por ejemplo "Hola mundo"

void setup(){
   Serial.begin(9600);
}
void loop(){
   if (Serial.available()) {
      string texto = Serial.print(Serial.readString();
      Serial.println(texto.lenght());
   }
}

Ejemplo 3

En este ejemplo debes enviar una frase por la consola por ejemplo "Apuntes de Arduino".

void setup(){
   Serial.begin(9600);
}
void loop(){
   if (Serial.available()) {
     String texto = Serial.readString();
     Serial.println(texto.length());
   }
}

Vea también


Referencias