CKTIS / JavaScript
Príznaky regulárnych výrazov: dotAll (`s`), `u`, `i` a `g`
Príznaky `s`, `u`, `i` a `g` určujú v tomto poradí správanie bodky pri koncoch riadkov, režim Unicode, rozlišovanie veľkosti písmen a globálne vyhľadávanie.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
/pattern/gsui
new RegExp("pattern", "gsui")
re.dotAll; re.unicode; re.ignoreCase; re.global; re.lastIndexPríznaky zapíš za koncovú lomku literálu (/a.b/gsui) alebo do druhého argumentu konštruktora (new RegExp("a.b", "gsui")). Na poradí nezáleží; neznámy alebo opakovaný príznak spôsobí SyntaxError. Vlastnosti dotAll, unicode, ignoreCase a global ukazujú, či sú nastavené s, u, i a g; nemenia ich. Tieto pravidlá platia v ECMAScripte 2024, ale podpora závisí od prostredia, v ktorom kód beží.
S príznakom s (dotAll) zástupná bodka . zodpovedá aj štyrom znakom konca riadka: \n, \r, U+2028 a U+2029. Kotvy ^ a $ sa tým nemenia; až m im umožní zodpovedať aj hraniciam riadkov. Zápis \. stále znamená doslovnú bodku.
u zapína režim Unicode: bodka spracuje platný náhradný pár, napríklad 😄, ako jeden kódový bod namiesto dvoch kódových jednotiek UTF-16. Kódový bod nemusí tvoriť celú grafému, teda znak vnímaný ako celok. u tiež sprísňuje syntax a nedá sa kombinovať s v (SyntaxError). i nerozlišuje veľkosť písmen; spolu s u používa jednoduché zjednotenie veľkosti písmen podľa Unicode, nezávislé od miestnych nastavení a bez rozšírenia ß na ss.
g umožňuje prechádzať neprekrývajúce sa zhody. S g a bez y vstavané exec() používa lastIndex ako pozíciu v jednotkách UTF-16 na určenie začiatku hľadania. Ak táto pozícia v režime Unicode leží vnútri platného náhradného páru, zhoda sa môže začať na začiatku tohto páru, teda pred lastIndex. Pri úspechu uloží exec() do lastIndex koniec zhody v jednotkách UTF-16, pri neúspechu tam nastaví 0. Aj test() môže meniť tento stav. Pred nezávislým hľadaním vynuluj lastIndex alebo použi nový objekt RegExp. Prázdna zhoda môže zablokovať cyklus s exec(). Pre argument RegExp vyžaduje String.prototype.matchAll() príznak g (inak TypeError), posúva sa za prázdne zhody a pracuje s kópiou, ktorej počiatočný lastIndex sa nastaví podľa aktuálnej hodnoty lastIndex originálu.
Príklady
{
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));
}Výsledok
["a\nb","A😄b"] [["A😄b"],["a\nb"],["a\nb"]] [3,8,0]
Prvý riadok ukazuje obe zhody. V druhom sa z úplnej sady postupne po jednom vynechajú `s`, `u` a `i`: zmizne zhoda cez koniec riadka, zhoda s emoji alebo zhoda s veľkým písmenom. Tretí riadok ukazuje `lastIndex` po dvoch úspechoch a jednom neúspechu.
Súvisiace lekcie
- JavaScript · Lekcia 10 · Pokročilá · Verzia: 4