Funkcia %RxFind

Príklad

Funkcia vráti index, na ktorom začína substring zodpovedajúci zadanému regulárnemu výrazu (1..n). 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.

;v reťazci hľadáme pozíciu výrazu "nejaky"
%RxFind("text nejaky text", "nejaky")				;vráti hodnotu 6

;v reťazci hľadáme pozíciu výrazu "nejaky" na začiatku
%RxFind("text nejaky text", "^nejaky")				;vráti hodnotu 0 - výraz "nejaky" sa nenáchádza na začiatku

;v reťazci hľadáme výraz "text" na začiatku
%RxFind("text nejaky text", "^text")				;vráti hodnotu 1, pretože výraz "text" sa náchádza na začiatku

;v reťazci hľadáme výraz "text" na konci
%RxFind("text nejaky text", "text$")				;vráti hodnotu 13, pretože výraz "text" sa nachádza na konci (začína na pozícii 13)

;v reťazci hľadáme výraz "xt" alebo výraz "ne"
%RxFind("text nejaky text", "xt | ne")				;vráti hodnotu 3, pretože výraz "xt" bol nájdený ako prvý a začína na pozícii 3

;v reťazci zisťujeme, či začína výrazom "nejaky", alebo končí výrazom "text"
%RxFind("text nejaky text", "^nejaky | text$")		;vráti hodnotu 12, pretože zadaný string končí výrazom "text" (a tento výraz začína na pozícii 12)

;v reťazci zisťujeme, či obsahuje znaky v rozsahu a-d
%RxFind("text nejaky text", "[a-d]")				;vráti hodnotu 9, pretože na tejto pozícii sa nachádza znak v rozsahu a-d

;v reťazci zisťujeme, či obsahuje znaky okrem znakov v rozsahu a-d
%RxFind("text nejaky text", "[^a-d]")				;vráti hodnotu 1, pretože na tejto pozícii sa nachádza znak, ktorý je mimo rozsahu a-d

;v reťazci zisťujeme, či obsahuje sekvenciu znaku 'e' 2-krát po sebe
%RxFind("text neejaky text", "e{2}")				;vráti hodnotu 7, pretože na tejto pozícii sa nachádza znak 'e' 2-krát po sebe

;v reťazci zisťujeme, či obsahuje výraz otá.zka, kde sa namiesto . nachádza práve jeden znak
%RxFind("Jedna otázka alebo otázočka", "otá.ka")	;vráti hodnotu 7, pretože na tejto pozícii sa nachádza výraz vyhovujúci zadanému regulárnemu výrazu

;v reťazci zisťujeme, či obsahuje výraz otá.*zka, kde sa namiesto .* nachádza niekoľko znakov, pričom zadaný reťazec prehľadávame od pozície 10 a zaujíma nás aj koncový index nájdeného výrazu
%RxFind("Jedna otázka alebo otázočka", "otá.*ka", 10, _last)	;vráti hodnotu 20, pretože na tejto pozícii sa nachádza výraz vyhovujúci zadanému regulárnemu výrazu, hodnota parametra _last = 27

Príklady regulárnych výrazov

Regulárny výraz	Význam
výraz	Hľadá zadaný výraz v stringu.
^výraz	Hľadá zadaný výraz na začiatku stringu.
výraz$	Hľadá zadaný výraz na konci stringu.
výraz1 \| výraz2	Hľadá jeden zo zadaných výrazov.
^výraz \| výraz$	Hľadá výraz na začiatku alebo na konci stringu.
[a-d]	Hľadá znaky v zadanom rozsahu.
[^a-d]	Hľadá všetky znaky okrem znakov v zadanom rozsahu (v tomto prípade všetky znaky okrem a,b,c,d).
a{5}"	Hľadá sekvenciu 5 znakov 'a' idúcich po sebe.
oper.tor	Hľadá slovo oper.tor, kde sa namiesto . nachádza práve jeden neznámy znak (nájde slová ako operátor, operator, operxtor, ...).
oper.*tor	Hľadá slovo oper.tor, kde sa namiesto . nachádza niekoľko neznámych znakov (nájde slová ako operátor, operator, operaaaaaator, ...).

Súvisiace stránky:

Implementované funkcie
Argumenty funkcie - typy

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).

Strom stránky

RxFind

Funkcia %RxFind