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_SENSITIVE` quando 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](https://docs.aws.amazon.com/quicksight/latest/user/avgIf-function.html), [minIf](https://docs.aws.amazon.com/quicksight/latest/user/minIf-function.html), [distinct\$1countIf](https://docs.aws.amazon.com/quicksight/latest/user/distinct_countIf-function.html), [countIf](https://docs.aws.amazon.com/quicksight/latest/user/countIf-function.html), [maxIf](https://docs.aws.amazon.com/quicksight/latest/user/maxIf-function.html), [medianIf](https://docs.aws.amazon.com/quicksight/latest/user/medianIf-function.html), [stdevIf](https://docs.aws.amazon.com/quicksight/latest/user/stdevIf-function.html), [stdevpIf](https://docs.aws.amazon.com/quicksight/latest/user/stdevpIf-function.html), [sumIf](https://docs.aws.amazon.com/quicksight/latest/user/sumIf-function.html), [varIf](https://docs.aws.amazon.com/quicksight/latest/user/varIf-function.html) e [varpIf](https://docs.aws.amazon.com/quicksight/latest/user/varpIf-function.html). 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) ) ```