A função REGEXEXTRACT permite extrair texto de uma cadeia de caracteres com base em uma expressão regular fornecida. Você pode extrair a primeira correspondência, todas as correspondências ou captura de grupos da primeira partida.
Sintaxe
A função REGEXEXTRACT extrai cadeias de caracteres dentro do texto fornecido que corresponde ao padrão.
A sintaxe da função REGEXEXTRACT é:
REGEXEXTRACT(texto, padrão, [return_mode], [case_sensitivity])
Argumento |
Descrição |
---|---|
texto (obrigatório) |
O texto ou a referência a uma célula que contém o texto do qual você deseja extrair cadeias de caracteres. |
padrão (obrigatório) |
A expressão regular ("regex") que descreve o padrão de texto que você deseja extrair. |
return_mode |
Um número que especifica quais cadeias de caracteres você deseja extrair. Por padrão, o modo de retorno é 0. Os valores possíveis são: 0: Retornar a primeira cadeia de caracteres que corresponde ao padrão 1: Retornar todas as cadeias de caracteres que correspondem ao padrão como uma matriz 2: Retornar grupos de captura da primeira correspondência como uma matriz Observação:A captura de grupos é parte de um padrão regex cercado por parênteses "(...)". Eles permitem que você retorne partes separadas de uma única correspondência individualmente. |
case_sensitivity |
Determina se a correspondência é sensível a casos. Por padrão, a correspondência é sensível a maiúsculas de minúsculas. Insira um dos seguintes: 0: Sensível ao caso 1: Caso insensível |
Observações:
-
Ao escrever padrões regex, símbolos chamados "tokens" podem ser usados que correspondem a uma variedade de caracteres. Estes são alguns tokens simples para referência:
-
"[0-9]": qualquer dígito numérico
-
"[a-z]": um caractere no intervalo de a a z
-
".": qualquer caractere
-
"a": o caractere "a"
-
"a*": zero ou mais "a"
-
"a+": um ou mais "a"
-
Todas as expressões regulares para essa função, bem como REGEXTEST e REGEXREPLACE usam o "sabor" PCRE2 de regex.
-
REGEXEXTRACT sempre retorna valores de texto. Você pode converter esses resultados de volta em um número com a função VALUE.
Exemplos
Copie os dados de exemplo e cole-os na célula A1 de uma nova planilha do Excel. Se precisar, você pode ajustar as larguras da coluna para ver todos os dados.
Extrair nomes com base em letras maiúsculas com o padrão "[A-Z][a-z]+"
Dados |
DylanWilliams |
Fórmulas |
=REGEXEXTRACT(A2,"[A-Z][a-z]+") |
=REGEXEXTRACT(A2,"[A-Z][a-z]+",1) |
A ilustração a seguir mostra os resultados.
Extrair números de telefone com base em sua estrutura com o padrão "[0-9()]+ [0-9-]+"
Dados |
Sonia Rees (378) 555-4195 Angel Brown (878) 555-8622 Blake Martin (437) 555-8987 William Kirby (619) 555-4212 Avery Smith (579) 555-5658 Parker Jones (346) 555-0925 Liam Small (405) 555-0887 Hollie Rees (666) 555-1872 |
Fórmulas |
=REGEXEXTRACT(A2"[0-9()]+ [0-9-]+",1) |
A ilustração a seguir mostra o resultado.