CKTIS / JavaScript
RegExp.prototype.exec — shoda a zachytávací skupiny
RegExp.prototype.exec hledá shodu a vrací pole obsahující odpovídající text a zachycené skupiny, nebo null. Příznaky g a y způsobují, že následná volání používají lastIndex a aktualizují jeho hodnotu.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
regexp.exec(string)regexp.exec(string) provádí hledání regulárním výrazem. Argument se převede na řetězec; vestavěná metoda vyžaduje jako this skutečnou instanci RegExp. Výsledkem je pole nebo null, nikoli logická hodnota. Před čtením vlastností výsledek zkontrolujte.
match[0] obsahuje celou shodu a match[1] a další prvky obsahují zachytávací skupiny. Skupina, která se shody neúčastnila, má hodnotu undefined. match.index je počáteční pozice v jednotkách kódu UTF-16 a match.input je prohledávaný řetězec. match.groups obsahuje pojmenované skupiny, nebo undefined, pokud je vzor neobsahuje. Příznak d navíc zpřístupňuje match.indices s dvojicemi začátku a konce; konec je výlučný.
Bez g a y začíná hledání na pozici 0 a lastIndex zůstává nezměněný. Je-li nastaven alespoň jeden z těchto příznaků, hledání použije jako výchozí pozici výsledek operace ToLength nad hodnotou lastIndex (například z 1.9 vznikne 1). S g, ale bez y, může hledání po neúspěšném pokusu zkoušet další pozice; s y je nezkouší. Pokud v režimu Unicode (u nebo v) převedená hodnota lastIndex ukazuje na druhou jednotku náhradního páru UTF-16, může shoda začít na první jednotce tohoto páru. Proto se i s y může vrácená hodnota match.index od převedené hodnoty lastIndex lišit. Při úspěchu se lastIndex nastaví na konec shody, při neúspěchu se vynuluje. Před opětovným použitím objektu pro nezávislé hledání nastavte lastIndex = 0.
Ve smyčce používejte stále stejný objekt RegExp. Pozor: prázdná shoda automaticky neposune lastIndex; bez výslovného posunu nebo ukončení se smyčka nemusí nikdy zastavit. Příklad používá vzor, který vždy odpovídá alespoň jednomu znaku, a ukazuje vynulování po posledním neúspěchu.
Pří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ýsledek
["x=12","x","12",0,4] ["y=7","y","7",5,8] 0
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.