CKTIS / JavaScript
RegExp.prototype.exec — zhoda a zachytávacie skupiny
RegExp.prototype.exec hľadá zhodu a vracia pole obsahujúce zodpovedajúci text a zachytené skupiny, alebo null. Príznaky g a y spôsobujú, že následné volania používajú lastIndex a aktualizujú jeho hodnotu.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
regexp.exec(string)regexp.exec(string) vykonáva hľadanie regulárnym výrazom. Argument sa prevedie na reťazec; vstavaná metóda vyžaduje ako this skutočnú inštanciu RegExp. Výsledkom je pole alebo null, nie logická hodnota. Pred čítaním vlastností výsledok skontrolujte.
match[0] obsahuje celú zhodu a match[1] a ďalšie prvky obsahujú zachytávacie skupiny. Skupina, ktorá sa na zhode nezúčastnila, má hodnotu undefined. match.index je počiatočná pozícia v jednotkách kódu UTF-16 a match.input je prehľadávaný reťazec. match.groups obsahuje pomenované skupiny alebo undefined, ak ich vzor nemá. Príznak d navyše sprístupňuje match.indices s dvojicami začiatku a konca; koniec je výlučný.
Bez g a y sa hľadanie začína na pozícii 0 a lastIndex zostáva nezmenený. Ak je nastavený aspoň jeden z týchto príznakov, hľadanie použije ako východiskovú pozíciu výsledok operácie ToLength na hodnote lastIndex (napríklad z 1.9 vznikne 1). S g, ale bez y, môže hľadanie po neúspešnom pokuse skúšať ďalšie pozície; s y ich neskúša. Ak v režime Unicode (u alebo v) prevedená hodnota lastIndex ukazuje na druhú jednotku náhradného páru UTF-16, zhoda sa môže začínať na prvej jednotke tohto páru. Preto sa aj s y môže vrátená hodnota match.index líšiť od prevedenej hodnoty lastIndex. Pri úspechu sa lastIndex nastaví na koniec zhody, pri neúspechu sa vynuluje. Pred opätovným použitím objektu na nezávislé hľadanie nastavte lastIndex = 0.
V cykle používajte stále ten istý objekt RegExp. Pozor: prázdna zhoda automaticky neposunie lastIndex; bez výslovného posunu alebo prerušenia sa cyklus nemusí nikdy skončiť. Príklad používa vzor, ktorý vždy zodpovedá aspoň jednému znaku, a ukazuje vynulovanie po poslednom neúspechu.
Príklady
const regexp = /([a-z]+)=(\d+)/g;
const text = "x=12 y=7";
let match;
while ((match = regexp.exec(text)) !== null) {
console.log(JSON.stringify([match[0], match[1], match[2], match.index, regexp.lastIndex]));
}
console.log(regexp.lastIndex);Výsledok
["x=12","x","12",0,4] ["y=7","y","7",5,8] 0
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.