Diferencia entre revisiones de «Serial.find()»
De ArduWiki
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: 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 | + | 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 == | ||
− | + | * 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 03:00 8 jul 2018
Contenido
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
}
}