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
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_SENSITIVE
cuando 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
) )