CKTIS / JavaScript
RegExp.prototype.exec — podudaranje i grupe za hvatanje
RegExp.prototype.exec traži podudaranje i vraća polje s podudarnim tekstom i uhvaćenim skupinama ili null. Zastavice g i y uzrokuju da uzastopni pozivi koriste lastIndex i ažuriraju njegovu vrijednost.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
regexp.exec(string)regexp.exec(string) provodi podudaranje regularnim izrazom. Argument se pretvara u niz znakova; ugrađena metoda zahtijeva stvarnu instancu RegExp kao this. Rezultat je polje ili null, a ne Booleova vrijednost. Provjerite rezultat prije čitanja njegovih svojstava.
match[0] sadrži cijelo podudaranje, a match[1] i sljedeći elementi sadrže grupe za hvatanje. Grupa koja nije sudjelovala u podudaranju daje undefined. match.index početni je položaj u UTF-16 kodnim jedinicama, a match.input je pretraživani niz znakova. match.groups sadrži imenovane grupe ili undefined ako ih uzorak nema. Zastavica d dodatno omogućuje match.indices s parovima početka i kraja; kraj je isključiv.
Bez zastavica g i y pretraživanje počinje na položaju 0 i ne mijenja lastIndex. Ako je postavljena barem jedna od tih zastavica, pretraživanje kao polazni položaj uzima rezultat primjene operacije ToLength na vrijednost lastIndex (primjerice, 1.9 postaje 1). Uz g, ali bez y, pretraživanje nakon neuspjelog pokušaja može provjeriti kasnije položaje; uz y ih ne provjerava. Ako u načinu rada Unicode (u ili v) pretvorena vrijednost lastIndex pokazuje na drugu kodnu jedinicu zamjenskog para UTF-16, podudaranje može početi na prvoj kodnoj jedinici tog para. Stoga se i uz y vrijednost u match.index može razlikovati od pretvorene vrijednosti lastIndex. Uspjeh postavlja lastIndex na kraj podudaranja, a neuspjeh ga vraća na nulu. Prije ponovne upotrebe tog objekta za neovisno pretraživanje postavite lastIndex = 0.
U petlji koristite isti objekt RegExp. Upozorenje: prazno podudaranje ne pomiče automatski lastIndex; bez izričitog pomicanja ili prekida petlja možda nikada neće završiti. Primjer koristi uzorak koji uvijek odgovara barem jednom znaku i pokazuje vraćanje vrijednosti na nulu nakon posljednjeg neuspjeha.
Primjeri
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);Rezultat
["x=12","x","12",0,4] ["y=7","y","7",5,8] 0
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.