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.
![REGEXEXTRACT é utilizado para extrair dados de nome com o padrão "[A-Z][a-z]+"](https://support.content.office.net/pt-br/media/1ee855b3-28a8-40de-a35a-47c9e948e881.png)
Extrair números de telefone com base em sua estrutura com o padrão "[0-9()]+ [0-9-]+"
|
Dados |
|
Sonia Rees (378) 555-4195 |
|
Fórmulas |
|
=REGEXEXTRACT(A2"[0-9()]+ [0-9-]+",1) |
A ilustração a seguir mostra o resultado.
![REGEXEXTRACT é utilizado para extrair vários números de telefone de um formato específico de texto misto, utilizando o padrão "[0-9()]+ [0-9-]+"](https://support.content.office.net/pt-br/media/57355548-590d-4e4c-86dd-95fb63afaf69.png)
