Funzioni IsMatch, Match e MatchAll

Si applica a: App canvas App basate su modello Interfaccia della riga di comando di Power Platform

Verifica la presenza di una corrispondenza o estrae parti di una stringa di testo in base a un modello.

Descrizione

La funzione IsMatch verifica se una stringa di testo corrisponde a un modello che può contenere caratteri ordinari, modelli predefiniti o un'espressione regolare. Le funzioni Match e MatchAll restituiscono le corrispondenze, incluse quelle secondarie.

Utilizzare IsMatch per convalidare ciò che un utente ha digitato in un controllo Text input. Ad esempio, è possibile verificare se l'utente ha immesso un indirizzo di posta elettronica valido prima che il risultato venga salvato nell'origine dati. Se l'immissione non corrisponde ai criteri, aggiungere altri controlli che richiedono all'utente di correggerla.

Usare Incontro per estrarre la prima stringa di testo che corrisponde a un modello e MatchAll per estrarre tutte le stringhe di testo corrispondenti. È anche possibile estrarre le corrispondenze secondarie per analizzare stringhe complesse.

Match restituisce un record di informazioni per la prima corrispondenza trovata e MatchAll restituisce una tabella di record per ogni corrispondenza trovata. Il record o i record contengono:

Queste funzioni supportano matchOptions. Per impostazione predefinita:

• Queste funzioni eseguono una corrispondenza con distinzione tra maiuscole e minuscole. Utilizzare MatchOptions.IgnoreCase per eseguire corrispondenze senza distinzione tra maiuscole e minuscole.
• IsMatch corrisponde all'intera stringa di testo ( CompleteMatchOption), mentre Match e MatchAll cercano una corrispondenza ovunque nella stringa di testo (ContainsMatchOption). Utilizzare Complete, Contains, BeginsWith o EndsWith come appropriato per il proprio scenario.

IsMatch restituisce true se la stringa di testo corrisponde al modello o false in caso contrario. Match restituisce blank se non viene trovata alcuna corrispondenza che può essere testata con la funzione IsBlank. MatchAll restituisce una tabella vuota se non viene trovata alcuna corrispondenza che può essere testata con la funzione IsEmpty.

Se si utilizza MatchAll per dividere una stringa di testo, considerare l'utilizzo della funzione Split, che è più semplice da usare e più veloce.

Modelli

La chiave per l'uso di queste funzioni è descrivere il criterio di corrispondenza. Si descrive il modello in una stringa di testo come una combinazione di:

• Caratteri normali, ad esempio "abc" o "123".
• Modelli predefiniti, ad esempio Letter, MultipleDigits o Email. L'enumerazione Match definisce questi modelli.
• Codici di espressioni regolari, ad esempio "\d+\s+\d+" o "[a-z]+".

Combina questi elementi usando l'operatore di concatenazione delle stringhe &. Ad esempio, "abc" & Digit & "\s+" è un modello valido che corrisponde ai caratteri "a", "b" e "c", seguiti da una cifra da 0 a 9, seguita da almeno uno spazio vuoto.

Caratteri ordinari

Il modello più semplice è una sequenza di caratteri normali che devono corrispondere esattamente.

Ad esempio, se utilizzata con la funzione IsMatch, la stringa "Hello" corrisponde esattamente al modello Hello. Non più e non meno. La stringa "hello!" non corrisponde al modello a causa del punto esclamativo alla fine e della "h" minuscola. Vedere MatchOptions per informazioni su come modificare questo comportamento.

Nel linguaggio del modello, alcuni caratteri sono riservati per scopi speciali. Per usare questi caratteri, aggiungere un prefisso al carattere con una \ (barra rovesciata) per indicare che il carattere deve essere considerato letteralmente oppure usare uno dei modelli predefiniti come descritto in seguito in questo argomento. Questa tabella elenca i caratteri speciali:

Ad esempio, puoi abbinare "Hello?" utilizzando il modello "Hello\?" con una barra rovesciata prima del punto interrogativo.

Modelli predefiniti

I modelli predefiniti offrono un modo semplice per trovare la corrispondenza tra un set di caratteri o una sequenza di più caratteri. Usa l'operatore di concatenazione delle stringhe & per combinare stringhe di testo con i membri dell'enumerazione Match:

Ad esempio, il modello "A" & MultipleDigits corrisponderà alla lettera "A" seguita da una o più cifre.

Espressioni regolari

Il modello utilizzato da queste funzioni è un'espressione regolare. I caratteri ordinari e i modelli predefiniti illustrati precedentemente in questo articolo consentono di creare espressioni regolari.

Le espressioni regolari sono molto efficaci, sono disponibili in molti linguaggi di programmazione e sono usate per molti scopi. Spesso possono anche apparire come una sequenza casuale di segni di punteggiatura. Questo articolo non illustra tutti gli aspetti delle espressioni regolari. Sul Web è possibile trovare un'ampia gamma di informazioni, esercitazioni e strumenti.

Le espressioni regolari sono disponibili in dialetti diversi e Power Apps usa una variante del dialetto JavaScript. Vedere Sintassi delle espressioni regolari per un'introduzione alla sintassi. Sono supportate le corrispondenze secondarie con nome (a volte denominate gruppi di acquisizione con nome):

• Corrispondenze secondarie con nome: (?<nome> ...)
• Backreferenze con nome: \k<nome>

Nella tabella di enumerazioni Match vista precedentemente in questo argomento, ogni enumerazione appare nella stessa riga della relativa espressione regolare corrispondente.

Opzioni di corrispondenza

Puoi modificare il comportamento di queste funzioni specificando una o più opzioni, che puoi combinare usando l'operatore di concatenazione di stringhe (&).

L'uso di MatchAll equivale a utilizzare il modificatore "g" standard per le espressioni regolari.

Sintassi

IsMatch( Text, Pattern [, Options ] )

• Text: obbligatorio. La stringa di testo da verificare.
• Pattern: obbligatorio. Il modello da verificare come stringa di testo. Concatenare modelli predefiniti che l'enumerazione Match definisce o specificare un'espressione regolare. Pattern deve essere una formula costante senza variabili, origini dati o altri riferimenti dinamici che cambiano durante l'esecuzione dell'app.
• Options: facoltativo. Una combinazione di stringhe di testo dei valori dell'enumerazione MatchOptions. Per impostazione predefinita, viene usato MatchOptions.Complete.

Match( Text, Pattern [, Options ] )

• Text: obbligatorio. La stringa di testo per la quale trovare una corrispondenza.
• Pattern: obbligatorio. Il modello per cui trovare una corrispondenza come stringa di testo. Concatenare modelli predefiniti che l'enumerazione Match definisce o specificare un'espressione regolare. Pattern deve essere una formula costante senza variabili, origini dati o altri riferimenti dinamici che cambiano durante l'esecuzione dell'app.
• Options: facoltativo. Una combinazione di stringhe di testo dei valori dell'enumerazione MatchOptions. Per impostazione predefinita, viene usato MatchOptions.Contains.

MatchAll( Text, Pattern [, Options ] )

• Text: obbligatorio. La stringa di testo per la quale trovare una corrispondenza.
• Pattern: obbligatorio. Il modello per cui trovare una corrispondenza come stringa di testo. Concatenare modelli predefiniti che l'enumerazione Match definisce o specificare un'espressione regolare. Pattern deve essere una formula costante senza variabili, origini dati o altri riferimenti dinamici che cambiano durante l'esecuzione dell'app.
• Options: facoltativo. Una combinazione di stringhe di testo dei valori dell'enumerazione MatchOptions. Per impostazione predefinita, viene usato MatchOptions.Contains.

Esempi di IsMatch

Caratteri ordinari

Si supponga che l'applicazione contenga un controllo Text input denominato TextInput1. L'utente immette i valori in questo controllo da archiviare in un database.

L'utente digita Hello world in TextInput1.

Modelli predefiniti

Espressioni regolari

Esempi di Match e MatchAll

Esploriamo l'ultimo esempio. Se si desidera convertire questa stringa in un valore data/ora utilizzando la funzione Time, è necessario passare individualmente le corrispondenze secondarie con nome. A questo proposito, è possibile usare la funzione With sul record che Match restituisce:

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

Per questi esempi, aggiungere un controllo Button, impostare la relativa proprietà OnSelect su questa formula, quindi selezionare il pulsante:

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

Formula	Descrizione	Risultato
Match( pangram, "THE", IgnoreCase )	Trovare tutte le corrispondenze di "THE" nella stringa di testo che la variabile pangram contiene. La stringa contiene due corrispondenze, ma viene restituita solo la prima poiché si sta utilizzando Match e non MatchAll. La colonna SubMatches è vuota perché non sono state definite corrispondenze secondarie.	{ FullMatch: "The", SubMatches: [ ], StartMatch: 32 }
MatchAll( pangram, "the" )	Trovare tutte le corrispondenze di "the" nella stringa di testo che la variabile pangram contiene. Il test fa distinzione tra maiuscole e minuscole, quindi viene trovata solo la seconda istanza di "the". La colonna SubMatches è vuota perché non sono state definite corrispondenze secondarie.
MatchAll( pangram, "the", IgnoreCase )	Trovare tutte le corrispondenze di "the" nella stringa di testo che la variabile pangram contiene. In questo caso, il test non fa distinzione tra maiuscole e minuscole, quindi vengono trovate entrambe le istanze della parola. La colonna SubMatches è vuota perché non sono state definite corrispondenze secondarie.
MatchAll( pangram, "\b\wo\w\b" )	Trova tutte le parole di tre lettere con una "o" nel mezzo. Si noti che "brown" è escluso perché non è una parola di tre lettere e, pertanto, non corrisponde a "\b" (limite di parole).
Match( pangram, "\b\wo\w\b\s\*(?<between>\w.+\w)\s\*\b\wo\w\b" )	Cerca la corrispondenza con tutti i caratteri tra "fox" e "dog".	{ between: "jumps over the lazy", FullMatch: "fox jumps over the lazy dog", SubMatches: [ "jumps over the lazy" ], StartMatch: 17 }

Per vedere i risultati di MatchAll in una raccolta:

1. In una schermata vuota, inserire un controllo Gallery vuota verticale.

2. Impostare la proprietà Items della raccolta su MatchAll( pangram, "\w+" ) o MatchAll( pangram, MultipleLetters ).

   

3. Selezionare "Aggiungi un elemento dalla scheda Inserisci" al centro del controllo gallery per selezionare il modello della raccolta.

4. Aggiungere un controllo Label al modello della raccolta.

5. Impostare la proprietà Text dell'etichetta su ThisItem.FullMatch.

   La raccolta viene riempita con ogni parola nel testo di esempio. Ridimensionare il modello della raccolta e il controllo Label per visualizzare tutte le parole in una schermata.