Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

RegExp.prototype.exec — ujemanje in zajemne skupine

RegExp.prototype.exec poišče ujemanje in vrne polje z ujemajočim se besedilom in zajetimi skupinami ali null. Zastavici g in y povzročita, da zaporedni klici uporabljajo lastIndex in posodabljajo njegovo vrednost.

Različica: 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) izvede iskanje z regularnim izrazom. Argument se pretvori v niz; vgrajena metoda za this zahteva dejanski primerek RegExp. Rezultat je polje ali null, ne logična vrednost. Pred branjem lastnosti preverite rezultat.

match[0] vsebuje celotno ujemanje, match[1] in naslednji elementi pa zajemne skupine. Skupina, ki pri ujemanju ni sodelovala, vrne undefined. match.index je začetni položaj v kodnih enotah UTF-16, match.input pa je niz, po katerem poteka iskanje. match.groups vsebuje poimenovane skupine ali undefined, če jih vzorec nima. Zastavica d dodatno omogoča match.indices s pari začetkov in koncev; konec je izključujoč.

Brez g in y se iskanje začne na položaju 0, lastIndex pa ostane nespremenjen. Če je nastavljena vsaj ena od teh zastavic, iskanje kot izhodiščni položaj uporabi rezultat operacije ToLength nad vrednostjo lastIndex (na primer 1.9 se pretvori v 1). Z g, vendar brez y, lahko iskanje po neuspelem poskusu preveri poznejše položaje; z y jih ne preveri. Če v načinu Unicode (u ali v) pretvorjena vrednost lastIndex kaže na drugo kodno enoto nadomestnega para UTF-16, se lahko ujemanje začne pri prvi kodni enoti tega para. Zato se lahko vrnjena vrednost match.index tudi z y razlikuje od pretvorjene vrednosti lastIndex. Ob uspehu se lastIndex nastavi na konec ujemanja, ob neuspehu pa se ponastavi na nič. Pred ponovno uporabo tega objekta za neodvisno iskanje nastavite lastIndex = 0.

V zanki uporabljajte isti objekt RegExp. Opozorilo: prazno ujemanje samodejno ne premakne lastIndex; brez izrecnega premika ali prekinitve se zanka morda nikoli ne konča. Primer uporablja vzorec, ki se vedno ujema z vsaj enim znakom, in prikazuje ponastavitev po zadnjem neuspehu.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri