Skip to content

Regex ​

Regex é um tipo nativo do tyrus. Ele representa uma expressão regular compilada e é escrito com um literal /padrão/flags.

Construção ​

tyrus
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.

Assinaturatest(str: string): boolean
tyrus
const matched: boolean = /cat/.test("a cat");
print(matched); // true

exec() ​

Retorna a primeira correspondência e suas capturas, ou um valor ausente quando não há correspondência.

Assinaturaexec(str: string): string[]?
tyrus
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.

AssinaturaexecAll(str: string): string[][]?
tyrus
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.

AssinaturatoString(): string
tyrus
const text: string = /cat/i.toString();
print(text); // /cat/i

Métodos de String com Regex ​

match() ​

Retorna a primeira correspondência e suas capturas, ou um valor ausente quando a string não corresponde.

Assinaturamatch(re: Regex): string[]?
tyrus
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.

AssinaturamatchAll(re: Regex): string[][]?
tyrus
const matches: string[][]? = "one two".matchAll(/\w+/);

if (matches) {
    print(matches[1][0]); // two
}

Retorna o índice inicial da primeira correspondência, ou -1 quando a string não corresponde.

Assinaturasearch(re: Regex): i32
tyrus
const index: i32 = "a cat".search(/cat/);
print(index); // 2

replace() ​

Substitui a primeira correspondência pela string de substituição.

Assinaturareplace(re: Regex, replacement: string): string
tyrus
const masked: string = "[email protected]".replace(/@.+$/, "@example.test");
print(masked); // [email protected]

split() ​

Divide a string em cada correspondência não sobreposta.

Assinaturasplit(re: Regex): string[]
tyrus
const parts: string[] = "one,two".split(/,/);
print(parts[1]); // two

Limitaçõ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.