IsMatchFunciones , Matchy MatchAll

Se aplica a: Aplicaciones de lienzo Copilot Studio Aplicaciones controladas por modelos de Power Platform Funciones de Power Platform Dataverse Power Pages

Comprueba si hay coincidencias o extrae partes de una cadena de texto en función de un patrón.

Descripción

La IsMatch función comprueba si una cadena de texto coincide con un patrón que puede incluir caracteres normales, patrones predefinidos o una expresión regular. Las Match funciones y MatchAll devuelven lo que se ha coinciden, incluidas las submatches.

Use IsMatch para validar lo que un usuario ha escrito en un control Entrada de texto . Por ejemplo, confirme si el usuario escribió una dirección de correo electrónico válida antes de guardar el resultado en el origen de datos. Si la entrada no coincide con los criterios, agregue otros controles que pidan al usuario que corrija la entrada.

Use Match para extraer la primera cadena de texto que coincida con un patrón y MatchAll para extraer todas las cadenas de texto que coincidan. Extraiga submatches para analizar cadenas complejas.

Match devuelve un registro de información para la primera coincidencia encontrada y MatchAll devuelve una tabla de registros para cada coincidencia encontrada. El registro o registros contienen:

Estas funciones admiten MatchOptions. De forma predeterminada:

• Estas funciones realizan una coincidencia entre mayúsculas y minúsculas. Utilice MatchOptions.IgnoreCase para realizar coincidencias con distinción entre mayúsculas y minúsculas.
• IsMatch coincide con la cadena de texto completa (Complete MatchOption), mientras que Match y MatchAll busca una coincidencia en cualquier lugar de la cadena de texto (Contiene MatchOption). Utilice Complete, Contains, BeginsWith o EndsWith según corresponda a su escenario.

IsMatch devuelve true si la cadena de texto coincide con el patrón o false si no lo hace. Match devuelve en blanco si no se encuentra ninguna coincidencia que se pueda probar con la función IsBlank . MatchAll devuelve una tabla vacía si no se encuentra ninguna coincidencia que se pueda probar con la función IsEmpty .

Si usa MatchAll para dividir una cadena de texto, considere la posibilidad de usar la función Split , que es más sencilla y rápida.

Patrones

La clave para usar estas funciones está en describir el patrón de coincidencia. El patrón en una cadena de texto se describe como una combinación de:

• Caracteres normales, como "abc" o "123".
• Patrones predefinidos, como Letter, MultipleDigits o Email. (La Match enumeración define estos patrones).
• Códigos de expresiones regulares, como "\d+\s+\d+" o "[a-z]+".

Combine estos elementos utilizando el operador de concatenación de cadenas &. Por ejemplo, "abc" & Digit & "\s+" es un patrón válido que busca la coincidencia de los caracteres "a", "b" y "c", seguido de un dígito del 0 al 9, seguido de al menos un carácter de espacio en blanco.

Caracteres normales

El patrón más sencillo es una secuencia de caracteres normales que coinciden exactamente.

Por ejemplo, cuando se usa con la IsMatch función , la cadena "Hello" coincide exactamente con el patrón "Hello ". Ni más ni menos. La cadena "hello!" no coincide con el patrón debido al signo de exclamación al final y porque el caso es incorrecto para la letra "h". (Consulte lasMatch opciones para ver las formas de modificar este comportamiento).

En el idioma del patrón, los caracteres . ? * + ( ) [ ] ^ $ | \ se reservan con fines especiales. Para usar estos caracteres, prefijo el carácter con una \ (barra diagonal inversa) para indicar que el carácter se debe tomar literalmente o usar uno de los patrones predefinidos. Por ejemplo, puede hacer coincidir la cadena "Hello?" mediante el patrón "Hello\\?" con una barra diagonal inversa antes del signo de interrogación.

Patrones predefinidos

Los patrones predefinidos proporcionan una manera sencilla de buscar coincidencia con un carácter de un conjunto de caracteres o con una secuencia de varios caracteres. Use el operador de concatenación de cadenas y para combinar sus propias cadenas de texto con miembros de la Match enumeración:

Por ejemplo, el patrón "A" y MultipleDigits coincide con la letra "A" seguida de uno o varios dígitos.

Power Apps usa una definición diferente para Match. EMail y Match. Guion. Evalúe Text( Match.Email ) para ver la expresión regular usada por el host.

Expresiones regulares

El patrón que usan estas funciones se denomina expresión regular. El dialecto específico de expresiones regulares de Power Fx se detalla en Expresiones regulares en Power Fx.

Las expresiones regulares son eficaces y sirven una amplia variedad de propósitos. También pueden parecerse a una secuencia aleatoria de signos de puntuación. En este artículo no se describen todos los aspectos de las expresiones regulares, pero hay una gran cantidad de información, tutoriales y herramientas disponibles en línea.

Las expresiones regulares tienen un historial largo y están disponibles en muchos lenguajes de programación. Cada lenguaje de programación tiene su propio dialecto de expresiones regulares y hay pocos estándares. Nos esforzamos por garantizar que la misma expresión regular proporcione el mismo resultado en todas las implementaciones de Power Fx. La compatibilidad no es fácil de lograr, ya que Power Fx se ejecuta sobre JavaScript y .NET que tienen diferencias significativas. Para dar cabida a la ejecución en distintas plataformas, las expresiones regulares de Power Fx se limitan a un subconjunto de características que se admiten ampliamente en todo el sector.

Como resultado, algunas expresiones regulares que pueden funcionar en otros entornos pueden bloquearse o requerir un ajuste en Power Fx. Los errores de tiempo de creación se notifican como características no admitidas. Esta es una de las razones por las que la expresión regular y las opciones deben ser una constante de tiempo de creación y no dinámica (por ejemplo, proporcionada en una variable).

Estos son algunos elementos básicos de expresiones regulares que crean complejidad al analizar un número.

Estos ejemplos solo dan un pequeño sabor a lo que pueden hacer las expresiones regulares. Normalmente se usan para validar números de identificación, direcciones de correo electrónico, números de teléfono, fechas y horas, y para extraer información de todo tipo de archivos de texto. Continúe su recorrido leyendo Expresiones regulares en Power Fx, experimento y use la web para obtener más información.

Match opciones

Modifique el comportamiento de estas funciones especificando una o varias opciones, que se combinan mediante el operador de concatenación de cadenas (&).

El uso MatchAll es el mismo que el uso del modificador "g" estándar para expresiones regulares.

Sintaxis

IsMatch( Text, Pattern [, Options ] )

• Texto – Obligatorio. La cadena de texto que se va a probar.
• Patrón – Obligatorio. El patrón que se va a probar como una cadena de texto. Concatenar patrones predefinidos que la Match enumeración define o proporciona una expresión regular. El patrón debe ser una fórmula constante sin variables, orígenes de datos u otras referencias dinámicas que cambien a medida que se ejecute la aplicación. Tenga en cuenta que la fórmula debe expresarse como "Match. PredefinidaPattern" por ejemplo, Match. Correo electrónico
• Opciones – Opcional. Una combinación de cadenas de texto de valores de enumeración MatchOptions. De forma predeterminada, se usa MatchOptions.Complete. Las opciones deben ser una fórmula constante sin variables, orígenes de datos u otras referencias dinámicas que cambien a medida que se ejecute la aplicación.

Match( Text, Pattern [, Options ] )

• Texto – Obligatorio. La cadena de texto que debe coincidir.
• Patrón – Obligatorio. El patrón que debe coincidir como una cadena de texto. Concatenar patrones predefinidos que define la Match enumeración o proporcionar una expresión regular. El patrón debe ser una fórmula constante sin variables, fuentes de datos ni otras referencias dinámicas que cambien a medida que se ejecuta la aplicación.
• Opciones – Opcional. Una combinación de cadenas de texto de valores de enumeración MatchOptions. De forma predeterminada, se usa MatchOptions.Contains. Las opciones deben ser una fórmula constante sin variables, orígenes de datos u otras referencias dinámicas que cambien a medida que se ejecute la aplicación.

MatchAll( Text, Pattern [, Options ] )

• Texto – Obligatorio. La cadena de texto que debe coincidir.
• Patrón – Obligatorio. El patrón que debe coincidir como una cadena de texto. Concatenar patrones predefinidos que la Match enumeración define o proporciona una expresión regular. El patrón debe ser una fórmula constante sin variables, orígenes de datos u otras referencias dinámicas que cambien a medida que se ejecute la aplicación.
• Opciones – Opcional. Una combinación de cadenas de texto de valores de enumeración MatchOptions. De forma predeterminada, se usa MatchOptions.Contains. Las opciones deben ser una fórmula constante sin variables, orígenes de datos u otras referencias dinámicas que cambien a medida que se ejecute la aplicación.

IsMatch Ejemplos

Caracteres normales

Imagine que la aplicación tiene un control entrada de texto denominado TextInput1. Los usuarios escriben valores en este control para almacenarlos en una base de datos.

Los usuarios escriben Hola mundo en TextInput1.

Patrones predefinidos

Expresiones regulares

Match y MatchAll ejemplos

Analicemos ese último ejemplo. Si desea convertir esta cadena en un valor de fecha y hora mediante la función Time , debe pasar individualmente las submatches con nombre. Para ello, use la función With que funciona en el registro que Match devuelve:

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

Para estos ejemplos, agregue un control Button, establezca su propiedad OnSelect en esta fórmula y luego seleccione el botón:

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

Fórmula	Descripción	Resultado
Match( pangram, "THE", IgnoreCase )	Encuentra todas las coincidencias de "THE" en la cadena de texto que contiene la variable pangram. La cadena contiene dos coincidencias, pero solo se devuelve la primera porque Match usa y no MatchAll.	{ FullMatch: "The", StartMatch: 32 }
MatchAll( pangram, "the" )	Encuentra todas las coincidencias de "the" en la cadena de texto que contiene la variable pangram. La prueba distingue entre mayúsculas y minúsculas, por lo que solo se encuentra la segunda instancia de "the".
MatchAll( pangram, "the", IgnoreCase )	Encuentra todas las coincidencias de "the" en la cadena de texto que contiene la variable pangram. En este caso, la prueba no distingue entre mayúsculas y minúsculas, por lo que se encuentran ambas instancias de la palabra.
MatchAll( pangram, "\b\wo\w\b" )	Encuentra todas las palabras de tres letras con una "o" en el medio. Se excluye "brown" porque no es una palabra de tres letras y, por lo tanto, no puede coincidir con "\b" (límite de palabra).
Match( pangram, "\b\wo\w\b\s\*(?<between>\w.+\w)\s\*\b\wo\w\b" )	Coincide con todos los caracteres entre "fox" y "dog".	{ entre: "salta sobre el diferido", FullMatch: "fox salta sobre el perro diferido", StartMatch: 17 }

Para ver los resultados de MatchAll en una galería:

1. En una pantalla vacía, inserte un control de galería vertical en blanco.

2. Establezca la propiedad MatchAllItems de la galería en ( pangram, "\w+" ) o MatchAll( pangram, MultipleLetters ).

   

3. Seleccione "Agregar un elemento de la pestaña Insertar" en el medio del control de galería para seleccionar la plantilla de la galería.

4. Agregue un control Label a la plantilla de la galería.

5. Establezca la propiedad Text de la etiqueta en ThisItem.FullMatch.

   La galería se llena con cada palabra en nuestro texto de ejemplo. Para ver todas las palabras en una pantalla, cambie el tamaño de la plantilla de la galería y el control de etiqueta.