Diferencia entre revisiones de «Serial.find()»

De ArduWiki
Saltar a: navegación, buscar
Línea 1: Línea 1:
 
== Descripción ==
 
== Descripción ==
Lee datos del buffer serial hasta que se encuentra la cadena objetivo de longitud dada.  
+
Lee datos del buffer serial hasta que se encuentra el caracter o la cadena objetivo de longitud dada; o se agote el tiempo de espera.  
  
 
== Sintaxis ==
 
== Sintaxis ==
 
<pre>
 
<pre>
 
Serial.find(caracter);
 
Serial.find(caracter);
 +
Serial.find(cadena);
 +
Serial.find(buffer, lon);
 
</pre>
 
</pre>
  
 
== Parametros ==
 
== Parametros ==
;caracter: Caracter a buscar.
+
;caracter: caracter a buscar ([[char]]).
 +
;cadena: cadena de caracteres [[string]] a buscar.
 +
;buffer: vector/matriz/secuencia de bytes ([[byte]]*) a buscar.
 +
;lon: la longitud del anterior ([[int]]).
  
 
== Retorna ==
 
== Retorna ==
Lo que devuelve es un boleano. La función devuelve verdadero si se encuentra la cadena objetivo, falsa si se agota el tiempo.  
+
Lo que devuelve es un [[bool]]. La función devuelve '''verdadero''' si se encuentra la cadena objetivo, '''falso''' si se agota el tiempo de espera sin encontrarla.  
  
 
== Advertencias ==
 
== Advertencias ==
Nada.
+
* La comparación es binaria; eso quiere decir que, para efectos de cadenas de caracteres, la búsqueda es sensible a las mayúsculas.
  
 
== Ejemplo ==
 
== Ejemplo ==

Revisión del 23:00 7 jul 2018

Descripción

Lee datos del buffer serial hasta que se encuentra el caracter o la cadena objetivo de longitud dada; o se agote el tiempo de espera.

Sintaxis

Serial.find(caracter);
Serial.find(cadena);
Serial.find(buffer, lon);

Parametros

caracter
caracter a buscar (char).
cadena
cadena de caracteres string a buscar.
buffer
vector/matriz/secuencia de bytes (byte*) a buscar.
lon
la longitud del anterior (int).

Retorna

Lo que devuelve es un bool. La función devuelve verdadero si se encuentra la cadena objetivo, falso si se agota el tiempo de espera sin encontrarla.

Advertencias

  • La comparación es binaria; eso quiere decir que, para efectos de cadenas de caracteres, la búsqueda es sensible a las mayúsculas.

Ejemplo

void setup(){
   Serial.begin(9600);
}
void loop(){
   if (Serial.available()){
      byte car = Serial.peek();    //Lee carácter enviado y NO borra del buffer.
      Serial.write(car);           //Imprime siempre lo mismo
   }
}

Vea también

Referencias