CKTIS / JavaScript
Zastavice regularnih izrazov: dotAll (`s`), `u`, `i` in `g`
Zastavice `s`, `u`, `i` in `g` določajo obnašanje pike pri prelomih vrstic, način Unicode, razlikovanje velikih in malih črk ter globalno iskanje.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
/pattern/gsui
new RegExp("pattern", "gsui")
re.dotAll; re.unicode; re.ignoreCase; re.global; re.lastIndexZastavice zapiši za zaključno poševnico literala (/a.b/gsui) ali kot drugi argument konstruktorja (new RegExp("a.b", "gsui")). Vrstni red ni pomemben; neznana ali ponovljena zastavica povzroči SyntaxError. Lastnosti dotAll, unicode, ignoreCase in global pokažejo, ali so nastavljene s, u, i in g; ne spreminjajo jih. Ta pravila veljajo v ECMAScriptu 2024, podpora pa je odvisna od izvajalnega okolja.
Z s (dotAll) se nadomestni znak . ujema tudi s štirimi znaki za konec vrstice: \n, \r, U+2028 in U+2029. To ne spremeni sider ^ in $; šele m jima omogoči ujemanje tudi na mejah vrstic. Zapis \. še vedno pomeni dobesedno piko.
u vklopi način Unicode: pika obravnava veljaven nadomestni par, na primer 😄, kot eno kodno točko namesto dveh kodnih enot UTF-16. Kodna točka ni nujno cel grafem, torej znak, ki ga uporabnik dojema kot enoto. u tudi zaostri pravila sintakse in ga ni mogoče združiti z v (SyntaxError). i ne razlikuje velikih in malih črk; skupaj z u uporablja preprosto poenotenje velikosti črk po standardu Unicode, neodvisno od območnih nastavitev in brez pretvorbe ß v ss.
g omogoča iteracijo po ujemanjih, ki se ne prekrivajo. Z g in brez y vgrajeni exec() uporabi lastIndex kot odmik v kodnih enotah UTF-16, da določi začetek iskanja. Če je v načinu Unicode ta odmik znotraj veljavnega nadomestnega para, se lahko ujemanje začne na začetku tega para, pred lastIndex. Ob uspehu exec() v lastIndex shrani konec ujemanja kot odmik v kodnih enotah UTF-16, ob neuspehu pa ga ponastavi na 0. Tudi test() lahko spremeni to stanje. Za neodvisno iskanje ponastavi lastIndex ali uporabi nov RegExp. Prazno ujemanje lahko ustavi napredovanje zanke z exec(). String.prototype.matchAll() za argument RegExp zahteva g (sicer TypeError), po praznem ujemanju napreduje in iterira s kopijo, katere začetni lastIndex se nastavi na trenutno vrednost lastIndex izvirnika.
Primeri
{
const text = "a\nb A😄b";
const re = /a.b/gsui;
const collect = (pattern) => Array.from(text.matchAll(pattern), (m) => m[0]);
console.log(JSON.stringify(collect(re)));
console.log(JSON.stringify([/a.b/gui, /a.b/gsi, /a.b/gsu].map(collect)));
const positions = [];
for (let n = 0; n < 3; n++) {
re.exec(text);
positions.push(re.lastIndex);
}
console.log(JSON.stringify(positions));
}Rezultat
["a\nb","A😄b"] [["A😄b"],["a\nb"],["a\nb"]] [3,8,0]
Prva vrstica pokaže obe ujemanji. V drugi iz celotnega nabora vsakič izpustimo eno zastavico, po vrsti `s`, `u` in `i`: izgine ujemanje čez prelom vrstice, ujemanje z emodžijem ali ujemanje z veliko črko. Tretja vrstica pokaže `lastIndex` po dveh uspehih in enem neuspehu.
Povezane lekcije
- JavaScript · Lekcija 10 · Napredna · Različica: 4