Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
contains
contains evalúa si la subcadena que especifique existe dentro de una expresión. Si la expresión contiene la subcadena, la función contains devuelve true y, en caso contrario, devuelve false.
Sintaxis
contains(expression,substring,string-comparison-mode)
Argumentos
- expresión
-
La expresión debe ser una cadena. Puede ser el nombre de un campo que utiliza el tipo de datos de cadena, un valor literal como
'12 Main Street'o una llamada a otra función que genera una cadena. - subcadena
-
El conjunto de caracteres que se comparan con la expresión. La subcadena puede aparecer una o más veces en la expresión.
- string-comparison-mode
-
(Opcional) Especifica el modo de comparación de cadenas que se va a utilizar:
-
CASE_SENSITIVE: las comparaciones de cadenas distinguen entre mayúsculas y minúsculas. -
CASE_INSENSITIVE: las comparaciones de cadenas no distinguen entre mayúsculas y minúsculas.
Este valor se establece de forma predeterminada en
CASE_SENSITIVEcuando está en blanco. -
Tipo de retorno
Booleano
Ejemplos
Ejemplo de distinción entre mayúsculas y minúsculas predeterminado
En el siguiente ejemplo, que distingue entre mayúsculas y minúsculas, se evalúa si state_nm contiene New.
contains(state_nm,"New")
Los siguientes son los valores de los campos.
New York new york
Para estos valores de campo, se devuelven los siguientes valores.
true false
Ejemplo que no distingue entre mayúsculas y minúsculas
En el siguiente ejemplo, que no distingue entre mayúsculas y minúsculas, se evalúa si state_nm contiene new.
contains(state_nm,"new", CASE_INSENSITIVE)
Los siguientes son los valores de los campos.
New York new york
Para estos valores de campo, se devuelven los siguientes valores.
true true
Ejemplo con instrucciones condicionales
La función contains se puede utilizar como instrucción condicional en las siguientes funciones If: avgIf, minIf, distinct_countIf, countIf, maxIf, medianIf, stdevIf, stdevpIf, sumIf, varIf y varpIf.
El siguiente ejemplo solo suma Sales si state_nm contiene New.
sumIf(Sales,contains(state_nm,"New"))
NO contiene un ejemplo
El operador condicional NOT se puede usar para evaluar si la expresión no contiene la subcadena especificada.
NOT(contains(state_nm,"New"))
Ejemplo de uso de valores numéricos
Los valores numéricos se pueden utilizar en los argumentos de la expresión o de la subcadena mediante la aplicación de la función toString.
contains(state_nm, toString(5) )
