Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # contains `contains` valuta se la sottostringa specificata esiste all'interno di un'espressione. Se l'espressione inizia con la sottostringa, contains restituisce true, altrimenti restituisce false. ## Sintassi ``` contains(expression, substring, string-comparison-mode) ``` ## Arguments (Argomenti) *espressione* L'espressione deve essere una stringa. Può trattarsi del nome di un campo che utilizza il tipo di dati stringa, un valore letterale come **'12 Main Street'**, o una chiamata a un'altra funzione che genera una stringa. *sottostringa* Il set di caratteri da confrontare con l'*espressione*. La sottostringa può presentarsi una o più volte nell'*espressione*. *string-comparison-mode* (Facoltativo) Specifica la modalità di confronto delle stringhe da utilizzare: + `CASE_SENSITIVE`: i confronti tra stringhe distinguono tra maiuscole e minuscole. + `CASE_INSENSITIVE`: i confronti tra stringhe distinguono tra maiuscole e minuscole. Per impostazione predefinita, questo valore è impostato su `CASE_SENSITIVE` quando è vuoto. ## Tipo restituito Booleano ## Esempi ### Esempio predefinito che distingue tra maiuscole e minuscole Il seguente esempio senza distinzione tra maiuscole e minuscole valuta se `state_nm` contiene **New**. ``` contains(state_nm, "New") ``` I seguenti sono i valori di campo forniti. ``` New York new york ``` Per questi valori di campo vengono restituiti i seguenti valori. ``` true false ``` ### Esempio senza distinzione tra maiuscole e minuscole Il seguente esempio senza distinzione tra maiuscole e minuscole valuta se `state_nm` contiene **new**. ``` contains(state_nm, "new", CASE_INSENSITIVE) ``` I seguenti sono i valori di campo forniti. ``` New York new york ``` Per questi valori di campo vengono restituiti i seguenti valori. ``` true true ``` ### Esempio con istruzioni condizionali La funzione contains può essere utilizzata come istruzione condizione all'interno delle seguenti funzioni 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). Il seguente esempio somma `Sales` solo se `state_nm` contiene **New**. ``` sumIf(Sales,contains(state_nm, "New")) ``` ### NON contiene esempi L'operatore `NOT` condizionale può essere utilizzato per valutare se l'espressione non contiene con la sottostringa specificata. ``` NOT(contains(state_nm, "New")) ``` ### Esempio di utilizzo dei valori numerici I valori numerici possono essere utilizzati negli argomenti di espressioni o sottostringhe applicando la funzione `toString`. ``` contains(state_nm, toString(5) ) ```