Porovnávané verzie

Kľúč

  • Tento riadok sa pridal
  • Riadok je odstránený.
  • Formátovanie sa zmenilo.

Funkcia %RxFind




Funkcia

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. Vyhľadávanie je citlivé na malé a veľké písmená.

Deklarácia


Blok kódu
languageesl
themeConfluence
INT %RxFind(
   TEXT in text,
   TEXT in regExp,
   INT	in from := 0,
   INT	out endIndex := 0
 )


Parametre


textText, ktorý bude prehľadaný.
regExpRegulárny výraz, ktorý bude hľadaný vo vstupnom parametri text.
fromIndex, od ktorého bude prehľadávaný vstupný parameter text (nepovinný vstupný internet).
endIndexIndex, 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 (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.

 



Blok kódu
languageesl
themeRDark
;v stringureťazci "text nejaky text" sa pokúšame sa nájsť začiatočný index hľadáme pozíciu výrazu "nejaky"
%RxFind("text nejaky text", "nejaky")				;vráti hodnotu 6, pretože výraz "nejaky" sa nachádza na pozícii 6 v zadanom stringu

;v stringureťazci "texthľadáme nejaky text" sa pokúšame nájsť výrazpozíciu výrazu "nejaky" na začiatku stringu
%RxFind("text nejaky text", "^nejaky")				;vráti hodnotu 0, pretože- výraz "nejaky" sa nenáchádza na začiatku zadaného stringu

;v stringureťazci "text nejaky text" sa pokúšame nájsť hľadáme výraz "text" na začiatku stringu
%RxFind("text nejaky text", "^text")				;vráti hodnotu 1, pretože výraz "text" sa náchádza na začiatku zadaného stringu (začína na pozícii 1)

;v stringu "text nejaky text" sa pokúšame nájsť reťazci hľadáme výraz "text" na konci stringu
%RxFind("text nejaky text", "text$")				;vráti hodnotu 13, pretože výraz "text" sa náchádzanachádza na konci zadaného stringu (začína na pozícii 13)

;v stringureťazci "text nejaky text" sa pokúšame nájsť 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 stringu "text nejaky text" sa snažíme zistiť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 stringu "text nejaky text" sa snažíme zistiť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 stringu "text nejaky text" sa snažíme zistiť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 stringu "text neejaky text" sa snažíme zistiť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 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
%RxFind("Jedna otázka alebo otázočka", "otá.*ka", 10)	;vráti hodnotu 20, pretože na tejto pozícii sa nachádza výraz vyhovujúci regulárnemu výrazu


%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


Príklady regulárnych výrazov


Regulárny výrazVýznam
výrazHľadá zadaný výraz v stringu.
^výrazHľadá zadaný výraz na začiatku stringu.
výraz$Hľadá zadaný výraz na konci stringu.
výraz1 | výraz2Hľ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.torHľadá slovo oper.tor, kde sa namiesto . nachádza práve jeden neznámy znak (nájde slová ako operátor, operator, operxtor, ...).
oper.*torHľadá slovo oper.*tor, kde sa namiesto .* nachádza niekoľko neznámych znakov (nájde slová ako operátor, operator, operaaaaaator, ...).