La función REGEXTEST permite comprobar si alguna parte del texto suministrado coincide con una expresión regular ("regex"). Se devolverá VERDADERO si hay una coincidencia y FALSO si no la hay.
Sintaxis
La función REGEXPRUEBA determina si alguna parte del texto coincide con el patrón.
La sintaxis de la función REGEXTEST es:
REGEXTEST(texto, patrón, [case_sensitivity])
| argumento | Descripción |
|---|---|
|
text (obligatorio) |
El texto o la referencia a una celda que contiene el texto con el que desea hacer coincidir. |
|
patrón (obligatorio) |
La expresión regular ("regex") que describe el patrón de texto que desea que coincida. |
| case_sensitivity | Determina si la coincidencia distingue mayúsculas de minúsculas. De forma predeterminada, la coincidencia distingue mayúsculas de minúsculas. Escribe una de las siguientes opciones: 0: Distingue mayúsculas de minús 1: No distingue mayúsculas de minúsculas |
Nota
Al escribir patrones de expresiones regulares, se pueden usar símbolos llamados 'tokens' que coinciden con una variedad de caracteres. Estos son algunos tokens simples como referencia:
- "[0-9]": cualquier dígito numérico
- "[a-z]": un carácter en el intervalo de a a z
- ".": cualquier carácter
- "A": el carácter "A"
- "a*": cero o más "a"
- "A+": uno o más "A"
- Todas las expresiones regulares de esta función, así como REGEXEXTRACT y REGEXREPLACE, usan el "sabor" de regex PCRE2.
- REGEXEXTRACT siempre devuelve valores de texto. Puede convertir estos resultados en un número con la función VALUE.
Ejemplos
Copie los datos de ejemplo y péguelos en la celda A1 de una nueva hoja de cálculo de Excel. Si lo necesita, puede ajustar el ancho de las columnas para ver todos los datos.
Ejemplo 1
Compruebe varios aspectos de la cadena 'alfalfa'
| Datos | |
|---|---|
| Alfalfa | |
| Fórmulas | Preguntas |
| =REGEXTEST(A2,"a") | ¿Contiene la letra 'a'? |
| =REGEXTEST(A2,"[a-z]") | ¿Contiene letras minúsculas? |
| =REGEXTEST(A2,"[A-Z]") | ¿Contiene letras mayúsculas? |
| =REGEXTEST(A2,"[aeiou]") | ¿Contiene vocales? |
| =REGEXTEST(A2,"[0-9]") | ¿Contiene algún número de dígitos? |
En la siguiente ilustración se muestran los resultados.
Ejemplo 2
Compruebe si los números de teléfono tienen el formato específico "(###) ###-####", usando el patrón:
"^\([0-9]{3}\) [0-9]{3}-[0-9]{4}$"
Nota
La barra diagonal inversa "\" se usa para "escapar" de los paréntesis "()" y algunos otros caracteres. En este patrón, "\(" se interpreta como "(" y "\)" se interpreta como ")"
| Datos |
|---|
| (378) 555-4195 |
| +1(878) 555-8622 |
| Fórmulas |
| =REGEXTEST(A2,"^\([0-9]{3}\) [0-9]{3}-[0-9]{4}$") |
| =REGEXTEST(A2,"^\([0-9]{3}\) [0-9]{3}-[0-9]{4}$") |
En la siguiente ilustración se muestra el resultado.
![Uso de REGEXTEST para comprobar si los números de teléfono están en una sintaxis específica, con el patrón ^\([0-9]{3}\) [0-9]{3}-[0-9]{4}$](../media/regextest-example-2.png)