As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
contains
contains avalia se a substring especificada existe em uma expressão. Se a expressão contiver a substring, a função contains retornará true, caso contrário, retornará false.
Sintaxe
contains(expression,substring,string-comparison-mode)
Argumentos
- expressão
-
A expressão deve ser uma string. Isso pode ser o nome de um campo que usa o tipo de dados de string, um valor literal, como
'12 Main Street', ou uma chamada para outra função que gere uma string. - substring
-
O conjunto de caracteres a serem comparados com a expressão. A substring pode ocorrer uma ou mais vezes na expressão.
- string-comparison-mode
-
(Opcional) Especifica o modo de comparação de strings a ser usado:
-
CASE_SENSITIVE: as comparações de strings diferenciam maiúsculas de minúsculas. -
CASE_INSENSITIVE: as comparações de strings não diferenciam maiúsculas de minúsculas.
Esse valor será padronizado como
CASE_SENSITIVEquando for deixado em branco. -
Tipo de retorno
Booleano
Exemplos
Exemplo padrão de diferenciação entre maiúsculas e minúsculas
O exemplo a seguir, com distinção entre maiúsculas e minúsculas, avalia se state_nm contém New.
contains(state_nm,"New")
A seguir estão os valores de campo especificados.
New York new york
Para esses valores de campo, os seguintes valores são retornados.
true false
Exemplo sem distinção entre maiúsculas e minúsculas
O exemplo a seguir, sem distinção entre maiúsculas e minúsculas, avalia se state_nm contém new.
contains(state_nm,"new", CASE_INSENSITIVE)
A seguir estão os valores de campo especificados.
New York new york
Para esses valores de campo, os seguintes valores são retornados.
true true
Exemplo com declarações condicionais
A função contains pode ser usada como a declaração condicional nas seguintes funções if: avgIf, minIf, distinct_countIf, countIf, maxIf, medianIf, stdevIf, stdevpIf, sumIf, varIf e varpIf.
O exemplo a seguir soma Sales somente se state_nm contiver New.
sumIf(Sales,contains(state_nm,"New"))
Exemplo does NOT contain
O operador condicional NOT pode ser usado para avaliar se a expressão não contém a substring especificada.
NOT(contains(state_nm,"New"))
Exemplo de uso com valores numéricos
Valores numéricos podem ser usados nos argumentos da expressão ou da substring aplicando a função toString.
contains(state_nm, toString(5) )
