Diferencia entre revisiones de «Stream.findUntil()»
De ArduWiki
(Página creada con «== Descripción == == Sintaxis == <pre> </pre> == Parametros == == Vea también == * Stream.read() * Stream.flush() * Stream.find() * Stream.peek() == R...») |
|||
Línea 1: | Línea 1: | ||
== Descripción == | == Descripción == | ||
+ | Lee datos del flujo de entrada hasta que: | ||
+ | *Se encuentre la cadena objetivo. | ||
+ | *Se encuentre la cadena terminadora. | ||
+ | *Se agote el tiempo de espera. | ||
== Sintaxis == | == Sintaxis == | ||
<pre> | <pre> | ||
+ | objetoStream.findUntil(target, terminal); | ||
+ | objetoStream.findUntil(bufObj, lonObj, bufTer, lonTer); | ||
</pre> | </pre> | ||
== Parametros == | == 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. | ||
== Vea también == | == Vea también == |
Revisión del 23:26 11 jul 2018
Contenido
Descripción
Lee datos del flujo de entrada hasta que:
- Se encuentre la cadena objetivo.
- Se encuentre la cadena terminadora.
- Se agote el tiempo de espera.
Sintaxis
objetoStream.findUntil(target, terminal); objetoStream.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.