Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje