Diferencia entre revisiones de «Serial.findUntil()»
De ArduWiki
(→Vea también) |
|||
| Línea 1: | Línea 1: | ||
== Descripción == | == Descripción == | ||
| − | + | Lee datos del buffer serial hasta que: | |
| + | *Se encuentre la cadena objetivo. | ||
| + | *Se encuentre la cadena terminadora. | ||
| + | *Se agote el tiempo de espera. | ||
== Sintaxis == | == Sintaxis == | ||
<pre> | <pre> | ||
Serial.findUntil(target, terminal); | Serial.findUntil(target, terminal); | ||
| + | Serial.findUntil(bufObj, lonObj, bufTer, lonTer); | ||
</pre> | </pre> | ||
== Parametros == | == Parametros == | ||
| − | ;target: la cadena a buscar [[ | + | ;target: la cadena a buscar ([[string]]). |
| − | ;terminal: la | + | ;terminal: la cadena terminadora ([[string]]). |
| + | ;bufObj: vector/matriz/secuencia de bytes ([[byte]]*) a buscar. | ||
| + | ;lonObj: longitud de la secuencia objetivo ([[int]]). | ||
| + | ;bufTer: vector/matriz/secuencia de bytes ([[byte]]*) terminadora. | ||
| + | ;lonTer: longitud de la secuencia terminadora ([[int]]). | ||
== Retorna == | == Retorna == | ||
| − | La función devuelve true si se encuentra la cadena de destino | + | La función devuelve ([[bool]]) '''true''' si se encuentra la cadena de destino; '''false''' si supera el tiempo de espera sin encontrarla, o se encuentra la cadena terminadora primero. |
== 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:16 8 jul 2018
Contenido
Descripción
Lee datos del buffer serial hasta que:
- Se encuentre la cadena objetivo.
- Se encuentre la cadena terminadora.
- Se agote el tiempo de espera.
Sintaxis
Serial.findUntil(target, terminal); Serial.findUntil(bufObj, lonObj, bufTer, lonTer);
Parametros
- target
- la cadena a buscar (string).
- terminal
- la cadena terminadora (string).
- bufObj
- vector/matriz/secuencia de bytes (byte*) a buscar.
- lonObj
- longitud de la secuencia objetivo (int).
- bufTer
- vector/matriz/secuencia de bytes (byte*) terminadora.
- lonTer
- longitud de la secuencia terminadora (int).
Retorna
La función devuelve (bool) true si se encuentra la cadena de destino; false si supera el tiempo de espera sin encontrarla, o se encuentra la cadena terminadora primero.
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
