Skip to content

Regex ​

Regex es un tipo nativo de tyrus. Representa una expresión regular compilada y se escribe con un literal /patrón/flags.

Construcción ​

tyrus
const slug: Regex = /^[a-z0-9-]+$/i;

Los patrones y las flags se validan durante la comprobación de tipos. new no forma parte de la construcción de Regex.

Flags ​

Las flags admitidas son i para coincidencia sin distinción entre mayúsculas y minúsculas, m para anclas multilínea, s para dot-all y x para el modo free-spacing. Las flags g, u, y y d no se admiten.

Métodos ​

test() ​

Devuelve si el patrón coincide en cualquier posición de una string.

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

exec() ​

Devuelve la primera coincidencia y sus capturas, o un valor ausente cuando no hay coincidencia.

Firmaexec(str: string): string[]?
tyrus
const match: string[]? = /(c)(at)/.exec("a cat");

if (match) {
    print(match[0]); // cat
    print(match[1]); // c
}

execAll() ​

Devuelve todas las coincidencias no superpuestas y sus capturas, o un valor ausente cuando no hay coincidencia.

FirmaexecAll(str: string): string[][]?
tyrus
const matches: string[][]? = /\w+/.execAll("one two");

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

toString() ​

Devuelve el patrón delimitado por barras y las flags activas.

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

Métodos de String con Regex ​

match() ​

Devuelve la primera coincidencia y sus capturas, o un valor ausente cuando la string no coincide.

Firmamatch(re: Regex): string[]?
tyrus
const match: string[]? = "a cat".match(/(c)(at)/);

if (match) {
    print(match[0]); // cat
}

matchAll() ​

Devuelve todas las coincidencias no superpuestas y sus capturas, o un valor ausente cuando la string no coincide.

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

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

Devuelve el índice inicial de la primera coincidencia, o -1 cuando la string no coincide.

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

replace() ​

Reemplaza la primera coincidencia con la string de reemplazo.

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

split() ​

Divide la string en cada coincidencia no superpuesta.

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

Limitaciones ​

Los valores Regex son inmutables. No existe lastIndex mutable, ni flag g, ni hooks de símbolos well-known, ni objeto de resultado de coincidencia, ni look-around o backreferences.