CKTIS / JavaScript
Příznaky regulárních výrazů: dotAll (`s`), `u`, `i` a `g`
Příznaky `s`, `u`, `i` a `g` řídí po řadě chování tečky na konci řádku, režim Unicode, rozlišování velikosti písmen a globální vyhledávání.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
/pattern/gsui
new RegExp("pattern", "gsui")
re.dotAll; re.unicode; re.ignoreCase; re.global; re.lastIndexPříznaky zapisuj za koncové lomítko literálu (/a.b/gsui) nebo do druhého argumentu konstruktoru (new RegExp("a.b", "gsui")). Na pořadí nezáleží; neznámý nebo opakovaný příznak způsobí SyntaxError. Vlastnosti dotAll, unicode, ignoreCase a global ukazují, zda jsou nastaveny s, u, i a g; nemění je. Tato pravidla platí v ECMAScriptu 2024, ale podpora závisí na běhovém prostředí.
S příznakem s (dotAll) odpovídá zástupná tečka . i čtyřem znakům konce řádku: \n, \r, U+2028 a U+2029. Kotvy ^ a $ se tím nemění; teprve m jim umožní odpovídat i hranicím řádků. Zápis \. stále znamená doslovnou tečku.
u zapíná režim Unicode: tečka zpracuje platný zástupný pár jako 😄 jako jeden kódový bod místo dvou kódových jednotek UTF-16. Kódový bod nemusí tvořit celý grafém, tedy znak vnímaný jako celek. u také zpřísňuje syntaxi a nelze ho kombinovat s v (SyntaxError). i nerozlišuje velikost písmen; spolu s u používá jednoduché sjednocení velikosti písmen podle Unicode, nezávislé na místním nastavení a bez rozšíření ß na ss.
g umožňuje procházet nepřekrývající se shody. S g a bez y používá vestavěné exec() hodnotu lastIndex jako pozici v jednotkách UTF-16 k určení začátku hledání. Pokud tato pozice v režimu Unicode leží uvnitř platného zástupného páru, shoda může začít na začátku tohoto páru, tedy před lastIndex. Při úspěchu uloží exec() do lastIndex koncovou pozici shody v jednotkách UTF-16, při neúspěchu tam nastaví 0. I test() může tento stav změnit. Před nezávislým hledáním vynuluj lastIndex nebo použij nový objekt RegExp. Prázdná shoda může zablokovat smyčku s exec(). Pro argument typu RegExp vyžaduje String.prototype.matchAll() příznak g (jinak TypeError), po prázdných shodách se posouvá dál a pracuje s kopií, jejíž počáteční lastIndex se nastaví podle aktuální hodnoty lastIndex originálu.
Pří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ýsledek
["a\nb","A😄b"] [["A😄b"],["a\nb"],["a\nb"]] [3,8,0]
První řádek ukazuje obě shody. Na druhém se z úplné sady postupně po jednom vynechají `s`, `u` a `i`: zmizí shoda přes konec řádku, shoda s emoji nebo shoda s velkým písmenem. Třetí řádek ukazuje `lastIndex` po dvou úspěších a jednom neúspěchu.
Související lekce
- JavaScript · Lekce 10 · Pokročilá · Verze: 4