Regex
Regex é um tipo nativo do tyrus. Ele representa uma expressão regular compilada e é escrito com um literal /padrão/flags.
Construção
const slug: Regex = /^[a-z0-9-]+$/i;Padrões e flags são validados durante a checagem de tipos. new não faz parte da construção de Regex.
Flags
As flags suportadas são i para correspondência sem distinção entre maiúsculas e minúsculas, m para âncoras multilinha, s para dot-all e x para o modo free-spacing. As flags g, u, y e d não são suportadas.
Métodos
test()
Retorna se o padrão corresponde em qualquer posição de uma string.
test(str: string): booleanconst matched: boolean = /cat/.test("a cat");
print(matched); // trueexec()
Retorna a primeira correspondência e suas capturas, ou um valor ausente quando não há correspondência.
exec(str: string): string[]?const match: string[]? = /(c)(at)/.exec("a cat");
if (match) {
print(match[0]); // cat
print(match[1]); // c
}execAll()
Retorna todas as correspondências não sobrepostas e suas capturas, ou um valor ausente quando não há correspondência.
execAll(str: string): string[][]?const matches: string[][]? = /\w+/.execAll("one two");
if (matches) {
print(matches[0][0]); // one
print(matches[1][0]); // two
}toString()
Retorna o padrão delimitado por barras e as flags ativas.
toString(): stringconst text: string = /cat/i.toString();
print(text); // /cat/iMétodos de String com Regex
match()
Retorna a primeira correspondência e suas capturas, ou um valor ausente quando a string não corresponde.
match(re: Regex): string[]?const match: string[]? = "a cat".match(/(c)(at)/);
if (match) {
print(match[0]); // cat
}matchAll()
Retorna todas as correspondências não sobrepostas e suas capturas, ou um valor ausente quando a string não corresponde.
matchAll(re: Regex): string[][]?const matches: string[][]? = "one two".matchAll(/\w+/);
if (matches) {
print(matches[1][0]); // two
}search()
Retorna o índice inicial da primeira correspondência, ou -1 quando a string não corresponde.
search(re: Regex): i32const index: i32 = "a cat".search(/cat/);
print(index); // 2replace()
Substitui a primeira correspondência pela string de substituição.
replace(re: Regex, replacement: string): stringconst masked: string = "[email protected]".replace(/@.+$/, "@example.test");
print(masked); // [email protected]split()
Divide a string em cada correspondência não sobreposta.
split(re: Regex): string[]const parts: string[] = "one,two".split(/,/);
print(parts[1]); // twoLimitações
Valores Regex são imutáveis. Não existe lastIndex mutável, nem flag g, nem hooks de símbolos well-known, nem objeto de resultado de correspondência, nem look-around ou backreferences.
