IsMatch, Matche MatchAll funções

Aplica-se a: Aplicativos de tela Copilot Studio Aplicativos baseados em modelo Power Platform CLI Dataverse funções 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 caracteres 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 as funções retornam o que foi correspondido, incluindo submatches.

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 email válido antes que o resultado seja salvo na fonte de dados. Se a entrada não corresponder aos 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 extrair todas as cadeias de caracteres de texto correspondentes. Extraia submatches 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 registro ou os registros contêm:

Essas funções dão suporte a MatchOptions. Por padrão:

• Essas funções executam uma correspondência que diferencia maiúsculas de minúsculas. Use MatchOptions.IgnoreCase para executar correspondências que não diferenciam maiúsculas de minúsculas.
• IsMatch corresponde a cadeia de caracteres de texto inteira (MatchOption Completa ) Match e MatchAll procura uma correspondência em qualquer lugar na cadeia de texto (contém MatchOption). Use Complete, Contains, BeginsWith ou EndsWith conforme apropriado para seu cenário.

IsMatch retornará true se a cadeia de caracteres de texto corresponder ao padrão ou false se não o fizer. Match retornará em branco se nenhuma correspondência for encontrada que possa ser testada com a função IsBlank . MatchAll retornará 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 caracteres de texto, considere usar a função Split , que é mais simples e rápida.

Padrões

A chave para usar essas funções é descrever o padrão para corresponder. Você descreve o padrão em uma cadeia de texto como uma combinação de:

• Caracteres normais, como "abc" ou "123".
• Padrões predefinidos, como letra, MultipleDigits, ou Email. (A Match enumeração define esses padrões.)
• Códigos de expressões regulares, como "\d+\s+\d+" ou "[a-z] +".

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

Caracteres 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 cadeia de caracteres "Hello" corresponde exatamente ao padrão "Olá" . Nem mais, nem menos. A cadeia "hello!" de caracteres não corresponde ao padrão devido ao ponto de exclamação no final e porque o caso está errado para a letra "h". (Consulte Match as opções de maneiras de 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 levado literalmente ou use um dos padrões predefinidos. Por exemplo, você pode corresponder à cadeia de "Hello?" caracteres usando o padrão "Hello\\?" com uma barra invertida antes do ponto de interrogação.

Padrões predefinidos

Padrões predefinidos fornecem uma maneira simples para corresponder a um conjunto de caracteres ou uma sequência de vários caracteres. Use o operador de concatenação de cadeia de caracteres e combine suas próprias cadeias de caracteres de texto com membros da Match enumeração:

Por exemplo, o padrão "A" & MultipleDigits corresponde à letra "A" seguida por 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 host.

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.

Expressões regulares são poderosas e servem a uma ampla variedade de finalidades. Eles também podem parecer uma sequência aleatória de marcas de pontuação. Este artigo não descreve todos os aspectos das expressões regulares, mas uma grande quantidade de informações, tutoriais e ferramentas estão disponíveis online.

Expressões regulares têm um longo histórico 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. 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 o Power Fx é executado 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 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. Erros de tempo de criação são relatados à medida que recursos sem suporte são encontrados. Esse é um dos motivos pelos 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.

Esses exemplos só dão um pequeno gostinho do que expressões regulares podem fazer. Eles geralmente são usados para validar números de ID, endereços de email, números de telefone, datas e horas e para extrair informações de todos os tipos de arquivos de texto. Continue seu percurso 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 de concatenação de cadeia de caracteres (>).

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 ser testada.
• Padrão – Obrigatório. O padrão a ser testado como uma cadeia de texto. Concatene padrões predefinidos que a Match enumeração define ou fornece 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 conforme o aplicativo é executado. Observe 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 padrão, MatchOptions.Complete é usado. As opções devem ser uma fórmula constante sem variáveis, fontes de dados ou outras referências dinâmicas que mudam conforme o aplicativo é executado.

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

• Texto – Obrigatório. A cadeia de texto a ser correspondida.
• Padrão – Obrigatório. O padrão a ser correspondido como uma cadeia de texto. Concatene padrões predefinidos que a Match enumeração define ou forneça 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 padrão, MatchOptions.Contains é usado. As opções devem ser uma fórmula constante sem variáveis, fontes de dados ou outras referências dinâmicas que mudam conforme o aplicativo é executado.

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

• Texto – Obrigatório. A cadeia de texto a ser correspondida.
• Padrão – Obrigatório. O padrão a ser correspondido como uma cadeia de texto. Concatene padrões predefinidos que a Match enumeração define ou fornece 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 conforme o aplicativo é executado.
• Opções – Opcional. Uma combinação de cadeia de texto de valores de enumeração MatchOptions. Por padrão, MatchOptions.Contains é usado. As opções devem ser uma fórmula constante sem variáveis, fontes de dados ou outras referências dinâmicas que mudam conforme o aplicativo é executado.

IsMatch Exemplos

Caracteres comuns

Imagine que seu aplicativo tenha 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 o último exemplo. Se você quiser converter essa cadeia de caracteres em um valor de data/hora usando a função Time , deverá passar os submatches nomeados 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 esses exemplos, adicione um controle Button, defina sua propriedade OnSelect como esta fórmula e, em seguida, selecione o botão:

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

Fórmula	Descrição	Resultado
Match( pangram, "THE", IgnoreCase )	Localiza 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 somente a primeira é retornada porque você está usando Match e não MatchAll.	{ FullMatch: "o", StartMatch: 32 }
MatchAll( pangram, "the" )	Localiza todas as correspondências de "the" na cadeia de texto que a variável pangram contém. O teste diferencia maiúsculas de minúsculas, portanto, somente a segunda instância de "the" é encontrada.
MatchAll( pangram, "the", IgnoreCase )	Localiza todas as correspondências de "the" na cadeia de texto que a variável pangram contém. Nesse caso, o teste não diferencia maiúsculas de minúsculas, portanto, 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. "brown" é excluído porque não é uma palavra de três letras e, portanto, não corresponde a "\b" (limite da palavra).
Match( pangram, "\b\wo\w\b\s\*(?<between>\w.+\w)\s\*\b\wo\w\b" )	Corresponde a todos os caracteres entre "raposa" e "cão".	{ entre: "pula sobre os preguiçosos", FullMatch: "raposa pula sobre o cão preguiçoso", StartMatch: 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 Itens da galeria comoMatchAll ( pangrama, "\w+" ) ou MatchAll( pangrama, MultipleLetters ).

   

3. Selecione "Adicionar um item da guia Inserir" no meio do controle da galeria para selecionar o modelo da galeria.

4. Adicione um controle Label ao modelo da galeria.

5. Defina a propriedade Text do rótulo como ThisItem.FullMatch.

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