IsMatch, Match, e MatchAll funções

Aplica-se a: Aplicativos do Canvas Aplicativos orientados por modelo do Copilot Studio Funções do Power Platform CLI Dataverse Power Pages

Testa uma correspondência ou extrai partes de uma cadeia de texto com base em um padrão.

Descrição

A IsMatch função testa se uma cadeia de texto corresponde a um padrão que pode incluir caracteres comuns, padrões predefinidos ou uma expressão regular. As Match funções e MatchAll retornam o que foi correspondido, incluindo subcorrespondências.

Use IsMatch para validar o que um usuário digitou em um controle de entrada de texto . Por exemplo, confirme se o usuário inseriu um endereço de e-mail válido antes que o resultado seja salvo na sua fonte de dados. Se a entrada não corresponder aos seus critérios, adicione outros controles que solicitam que o usuário corrija a entrada.

Use Match para extrair a primeira cadeia de caracteres de texto que corresponde a um padrão e MatchAll para extrair todas as cadeias de texto que correspondem. Extraia subcorrespondências para analisar cadeias de caracteres complexas.

Match Retorna um registro de informações para a primeira correspondência encontrada e MatchAll retorna uma tabela de registros para cada correspondência encontrada. O registo ou registos contêm:

Estas funções suportam MatchOptions. Por predefinição:

• Estas funções fazem uma correspondência sensível a maiúsculas e minúsculas. Utilize MatchOptions.IgnoreCase para efetuar correspondências não sensíveis a maiúsculas e minúsculas.
• IsMatch corresponde a toda a cadeia de texto (Complete MatchOption), enquanto Match e MatchAll procure uma correspondência em qualquer lugar na cadeia de texto (Contains MatchOption). Utilize Complete, Contains, BeginsWith ou EndsWith, conforme seja adequado ao seu cenário.

IsMatch Retorna true se a cadeia de caracteres de texto corresponder ao padrão ou false se não corresponder. Match retorna em branco se nenhuma correspondência for encontrada que possa ser testada com a função IsBlank . MatchAll retorna uma tabela vazia se nenhuma correspondência for encontrada que possa ser testada com a função IsEmpty .

Se você usar MatchAll para dividir uma cadeia de texto, considere usar a função Dividir , que é mais simples e rápida.

Padrões

A chave para utilizar estas funções reside em descrever o padrão para fazer a correspondência. Descreva o padrão numa cadeia de texto como uma combinação de:

• Carateres comuns, como "abc" ou "123".
• Padrões predefinidos, como Letra, MultipleDigits ou E-mail. (O Match enum define esses padrões.)
• Códigos de expressão regular, como "\d+\s+\d+" ou "[a-z]+".

Combine esses elementos usando o operador string-concatenation &. Por exemplo, "abc" e dígito e "\s+" é um padrão válido que corresponde aos carateres "a", "b", e "c", seguido de um dígito de 0 a 9, seguido de pelo menos um espaço em branco.

Carateres comuns

O padrão mais simples é uma sequência de caracteres comuns que correspondem exatamente.

Por exemplo, quando usada com a IsMatch função, a string "Hello" corresponde exatamente ao padrão "Hello". Nem mais, nem menos. A string "hello!" não corresponde ao padrão por causa do ponto de exclamação no final e porque o caso está errado para a letra "h". (Consulte Match as opções para saber como modificar esse comportamento.)

Na linguagem padrão, os caracteres . ? * + ( ) [ ] ^ $ | \ são reservados para fins especiais. Para usar esses caracteres, prefixe o caractere com uma \ barra invertida para indicar que o caractere deve ser tomado literalmente ou use um dos padrões predefinidos. Por exemplo, você pode corresponder à cadeia de caracteres "Hello?" usando o padrão "Hello\\?" com uma barra invertida antes do ponto de interrogação.

Padrões predefinidos

Os padrões predefinidos oferecem uma forma simples de corresponder a um conjunto de carateres, ou uma sequência de vários carateres. Use o operador de concatenação de cadeia de caracteres & para combinar suas próprias cadeias de texto com membros do Match enum:

Por exemplo, o padrão "A" & MultipleDigits corresponde à letra "A" seguida de um ou mais dígitos.

O Power Apps usa uma definição diferente para Match. EMail e Match. Hífen. Avalie Text( Match.Email ) para ver a expressão regular usada pelo seu anfitrião.

Expressões regulares

O padrão que essas funções usam é chamado de expressão regular. O dialeto específico de expressões regulares do Power Fx é detalhado em Expressões regulares no Power Fx.

As expressões regulares são poderosas e servem uma grande variedade de propósitos. Eles também podem se parecer com uma sequência aleatória de sinais de pontuação. Este artigo não descreve todos os aspetos das expressões regulares, mas uma grande variedade de informações, tutoriais e ferramentas estão disponíveis online.

As expressões regulares têm uma longa história e estão disponíveis em muitas linguagens de programação. Cada linguagem de programação tem seu próprio dialeto de expressões regulares, e há poucos padrões. Nós nos esforçamos para garantir que a mesma expressão regular dê o mesmo resultado em todas as implementações do Power Fx. A compatibilidade não é fácil de realizar, pois Power Fx é executada em cima do JavaScript e do .NET, que têm diferenças significativas. Para acomodar a execução em diferentes plataformas, as expressões regulares do Power Fx são limitadas a um subconjunto de recursos que são amplamente suportados em todo o setor.

Como resultado, algumas expressões regulares que podem funcionar em outros ambientes podem ser bloqueadas ou exigir um ajuste no Power Fx. Os erros de tempo de criação são relatados à medida que recursos sem suporte são encontrados. Esta é uma das razões pelas quais a expressão regular e as opções devem ser uma constante de tempo de criação e não dinâmica (por exemplo, fornecida em uma variável).

Aqui estão alguns elementos básicos de expressões regulares que criam complexidade na análise de um número.

Estes exemplos apenas dão uma pequena amostra do que as expressões regulares podem fazer. Eles são comumente usados para validar números de identificação, endereços de e-mail, números de telefone, datas e horas, e para extrair informações de todos os tipos de arquivos de texto. Continue sua jornada lendo Expressões regulares no Power Fx, experimente e use a Web para saber mais.

Match Opções

Modifique o comportamento dessas funções especificando uma ou mais opções, que você combina usando o operador string-concatenation (&).

Usar MatchAll é o mesmo que usar o modificador "g" padrão para expressões regulares.

Sintaxe

IsMatch( Texto, Padrão [, Opções ] )

• Texto – Obrigatório. A cadeia de texto a testar.
• Padrão – Obrigatório. O padrão a testar como uma cadeia de texto. Concatenar padrões predefinidos que o Match enum define ou fornecer uma expressão regular. O padrão deve ser uma fórmula constante sem variáveis, fontes de dados ou outras referências dinâmicas que mudam à medida que o aplicativo é executado. Note-se que a fórmula deve ser expressa como "Match. PredefinedPattern", por exemplo, Match. Email
• Opções – Opcional. Uma combinação de cadeia de texto de valores de enumeração MatchOptions. Por predefinição, é utilizado MatchOptions.Complete. As opções devem ser uma fórmula constante sem variáveis, fontes de dados ou outras referências dinâmicas que mudam à medida que o aplicativo é executado.

Match( Texto, Padrão [, Opções ] )

• Texto – Obrigatório. A cadeia de texto a corresponder.
• Padrão – Obrigatório. O padrão a corresponder como uma cadeia de texto. Concatenar padrões predefinidos que o Match enum define, ou fornecer uma expressão regular. O padrão deve ser uma fórmula constante sem variáveis, fontes de dados ou outras referências dinâmicas que mudam à medida que o aplicativo é executado.
• Opções – Opcional. Uma combinação de cadeia de texto de valores de enumeração MatchOptions. Por predefinição, é utilizado MatchOptions.Contains. As opções devem ser uma fórmula constante sem variáveis, fontes de dados ou outras referências dinâmicas que mudam à medida que o aplicativo é executado.

MatchAll( Texto, Padrão [, Opções ] )

• Texto – Obrigatório. A cadeia de texto a corresponder.
• Padrão – Obrigatório. O padrão a corresponder como uma cadeia de texto. Concatenar padrões predefinidos que o Match enum define ou fornecer uma expressão regular. O padrão deve ser uma fórmula constante sem variáveis, fontes de dados ou outras referências dinâmicas que mudam à medida que o aplicativo é executado.
• Opções – Opcional. Uma combinação de cadeia de texto de valores de enumeração MatchOptions. Por predefinição, é utilizado MatchOptions.Contains. As opções devem ser uma fórmula constante sem variáveis, fontes de dados ou outras referências dinâmicas que mudam à medida que o aplicativo é executado.

IsMatch Exemplos

Carateres comuns

Imagine que seu aplicativo tem um controle de entrada de texto chamado TextInput1. Os usuários inserem valores nesse controle para armazená-los em um banco de dados.

Os usuários digitam Hello world em TextInput1.

Padrões predefinidos

Expressões regulares

Match e MatchAll exemplos

Vamos analisar este último exemplo. Se você quiser converter essa cadeia de caracteres em um valor de data/hora usando a função Time , deverá passar as subcorrespondências nomeadas individualmente. Para fazer isso, use a função With operando no registro que Match retorna:

With(
    Match( "PT2H1M39S", "PT(?:(?<hours>\d+)H)?(?:(?<minutes>\d+)M)?(?:(?<seconds>\d+)S)?" ),
   Time( Value( hours ), Value( minutes ), Value( seconds ) )
)

Para estes exemplos, adicione um controlo Button, defina a respetiva propriedade OnSelect nesta fórmula e selecione o botão:

Set( pangram, "The quick brown fox jumps over the lazy dog." )

Fórmula	Descrição	Resultado
Match( pangram, "THE", IgnoreCase )	Localize todas as correspondências de "THE" na cadeia de texto que a variável pangram contém. A cadeia de caracteres contém duas correspondências, mas apenas a primeira é retornada porque você está usando Match e não MatchAll.	{ FullMatch: "O", Partida: 32 }
MatchAll( pangram, "the" )	Localize todas as correspondências de "the" na cadeia de texto que a variável pangram contém. O teste é sensível a maiúsculas e minúsculas, pelo que só é encontrada a segunda instância de "the".
MatchAll( pangram, "the", IgnoreCase )	Localize todas as correspondências de "the" na cadeia de texto que a variável pangram contém. Neste caso, o teste é sensível a maiúsculas e minúsculas, pelo que ambas as instâncias da palavra são encontradas.
MatchAll( pangram, "\b\wo\w\b" )	Localiza todas as palavras de três letras com um "o" no meio. "marrom" é excluído porque não é uma palavra de três letras e, portanto, não corresponde a "\b" (limite de palavras).
Match( pangram, "\b\wo\w\b\s\*(?<between>\w.+\w)\s\*\b\wo\w\b" )	Corresponde a todos os caracteres entre "fox" e "dog".	{ entre: "salta por cima do", FullMatch: "raposa salta por cima do cão preguiçoso", Partida: 17 }

Para ver os resultados de MatchAll uma galeria:

1. Em uma tela vazia, insira um controle de galeria vertical em branco.

2. Defina a propriedade Items da galeria como MatchAll( pangram, "\w+" ) ou MatchAll( pangram, MultipleLetters ).

   

3. Selecione "Adicionar um item do separador Inserir" no meio do controlo gallery para selecionar o modelo da galeria.

4. Adicione um controlo Label ao modelo da galeria.

5. Defina a propriedade Text da etiqueta como ThisItem.FullMatch.

   A galeria é preenchida com cada palavra no nosso texto de exemplo. Para ver todas as palavras em uma tela, redimensione o modelo da galeria e o controle de rótulo.