Funkcia nájde vo vstupnom texte prvý substring zodpovedajúci zadanému regulárnemu výrazu a vráti index, na ktorom sa daný substring začína.
Deklarácia
INT %RxFind(
TEXT in text,
TEXT in regExp,
INT in from := 0,
INT out endIndex := 0
)
Parametre
text
Text, ktorý bude prehľadaný.
regExp
Regulárny výraz, ktorý bude hľadaný vo vstupnom parametri text.
from
Index, od ktorého bude prehľadávaný vstupný parameter text (nepovinný vstupný internet).
endIndex
Index, na ktorom končí substring zodpovedajúci zadanému regulárnemu výrazu (nepovinný výstupný parameter).
Príklad
Funkcia vráti index, na ktorom začína substring zodpovedajúci zadanému regulárnemu výrazu. Voliteľný je parameter endIndex. Ak je tento parameter zadaný, po volaní funkcie je jeho hodnota rovná koncovému indexu substringu, ktorý vyhovuje zadanému regulárnemu výrazu.
Ak je hľadanie neúspešné, alebo ak je parameter from presahujúci celkovú dĺžku vstupného textu, funkcia vráti hodnotu 0.
Ak parameter regExp nie je platný regulárny výraz, funkcia vráti hodnotu -1.
Ak je niektorý zo vstupných parameterov neplatný, funkcia vráti nedefinovanú hodnotu.
%RxFind("text nejaky text", "[a-z]+") ;vráti hodnotu 1
%RxFind("text nejaky text", "[a-z]+", 1) ;vráti hodnotu 1
%RxFind("123text nejaky text", "[a-z]+", 1) ;vráti hodnotu 4
%RxFind("text nejaky text", "[a-z]+", 5, _last) ;vráti hodnotu 6, _last = 11
%RxFind("text nejaky text", "[a-z]+", 20, _last) ;vráti hodnotu -1, _last = -1
%RxFind("text nejaky text", "", 20, _last) ;vráti nedefinovanú hodnotu (dĺžka regulárneho výrazu je 0), _last = 0