Diferencia entre revisiones de «Serial.findUntil()»

De ArduWiki
Saltar a: navegación, buscar
(Parametros)
(Referencias)
 
(No se muestran 4 ediciones intermedias de 2 usuarios)
Línea 1: Línea 1:
 
== Descripción ==
 
== Descripción ==
lee datos del buffer serie hasta que se encuentre una cadena de destino de una longitud dada o hasta la encontrar la terminación de la cadena.
+
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 [[char]].
+
;target: la cadena a buscar ([[string]]).
;terminal: la finalización de la cadena buscada. Tipo [[char]].
+
;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, false si supera el tiempo de espera.
+
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 ==
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 ==
Línea 22: Línea 30:
  
 
== 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:47 6 may 2019

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

Vea también


Referencias