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à.

# in
<a name="in-function"></a>

`in` valuta se un'espressione esiste all'interno di un elenco di letterali. Se l'elenco non contiene l'espressione, in restituisce true, altrimenti restituisce false. `in` fa distinzione tra maiuscole e minuscole per gli input di tipo stringa.

`in` accetta due tipi di elenco di letterali, uno è un elenco inserito manualmente e l'altro è un [parametro multi-valore](https://docs.aws.amazon.com/quicksight/latest/user/parameters-in-quicksight.html).

## Sintassi
<a name="in-function-syntax"></a>

Utilizzando un elenco inserito manualmente:

```
in(expression, [literal-1, ...])  
```

Utilizzando un parametro multi-valore:

```
in(expression, $multivalue_parameter)
```

## Arguments (Argomenti)
<a name="in-function-arguments"></a>

 *espressione*   
L'espressione da confrontare con gli elementi dell'elenco di letterali. Può essere un nome di campo come `address`, un valore letterale come '**Unknown**', un parametro a valore singolo o una chiamata a un'altra funzione scalare, purché questa funzione non sia una funzione aggregata o un calcolo di tabella.

 *elenco di letterali*   
(obbligatorio) Può trattarsi di un elenco inserito manualmente o di un parametro multi-valore. Questo argomento accetta fino a 5.000 elementi. Tuttavia, in una query diretta a un'origine dati di terze parti, ad esempio Oracle o Teradata, la restrizione può essere minore.  
+ ***elenco inserito manualmente***: uno o più valori letterali in un elenco da confrontare con l'espressione. L'elenco deve essere racchiuso tra parentesi quadrate. Tutti i valori letterali da confrontare devono avere lo stesso tipo di dati dell'espressione. 
+ ***parametro multi-valore***: un parametro multivalore predefinito passato come elenco di letterali. Il parametro multi-valore deve avere lo stesso tipo di dati dell'espressione. 


## Tipo restituito
<a name="in-function-return-type"></a>

Valore booleano: TRUE/FALSE

## Esempio con un elenco statico
<a name="in-function-example-static-list"></a>

L'esempio seguente valuta il campo `origin_state_name` per i valori in un elenco di stringhe. Quando si confrontano input di tipo di stringa, `in` supporta solo il confronto con distinzione tra maiuscole e minuscole

```
in(origin_state_name,["Georgia", "Ohio", "Texas"])
```

I seguenti sono i valori di campo forniti.

```
"Washington"
        "ohio"
        "Texas"
```

Per questi valori di campo vengono restituiti i seguenti valori.

```
false
        false
        true
```

Il terzo valore restituito è true in quanto solo "Texas" è uno dei valori inclusi.

L'esempio seguente valuta il campo `fl_date` per i valori in un elenco di stringhe. Per far corrispondere il tipo, `toString` viene utilizzato per convertire il tipo di data in un tipo di stringa.

```
in(toString(fl_date),["2015-05-14","2015-05-15","2015-05-16"])
```

![\[Un'immagine dei risultati dell'esempio della funzione, sotto forma di tabella.\]](http://docs.aws.amazon.com/it_it/quick/latest/userguide/images/in-function-example-manual-list.png)


I valori letterali e NULL sono supportati nell'argomento dell'espressione da confrontare con i valori letterali nell'elenco. Entrambi i due esempi seguenti genereranno una nuova colonna di valori TRUE. 

```
in("Washington",["Washington","Ohio"])
```

```
in(NULL,[NULL,"Ohio"])
```

## Esempio con parametro multi-valore
<a name="in-function-example-mutivalue-parameter"></a>

Supponiamo che un autore crei un [parametro multi-valore](https://docs.aws.amazon.com/quicksight/latest/user/parameters-in-quicksight.html) che contiene un elenco di tutti i nomi degli stati. Quindi l'autore aggiunge un controllo per consentire al lettore di selezionare i valori dall'elenco.

Successivamente, il lettore seleziona tre valori, "Georgia", "Ohio" e "Texas", dal controllo dell'elenco a discesa del parametro. In questo caso, l'espressione seguente è equivalente al primo esempio, in cui questi tre nomi di stati vengono passati come elenco letterale da confrontare con il campo `original_state_name`. 

```
in (origin_state_name, ${stateName MultivalueParameter})
```

## Esempio con `ifelse`
<a name="in-function-example-with-ifelse"></a>

`in` può essere nidificato in altre funzioni come valore booleano. Un esempio è che gli autori possono valutare qualsiasi espressione in un elenco e restituire il valore desiderato utilizzando `in` e `ifelse`. L'esempio seguente valuta se l'oggetto `dest_state_name` di un volo si trova in un particolare elenco di stati degli Stati Uniti e restituisce diverse categorie di stati in base al confronto.

```
ifelse(in(dest_state_name,["Washington", "Oregon","California"]), "WestCoastUSState", "Other US State")
```

![\[Un'immagine dei risultati dell'esempio della funzione, sotto forma di tabella.\]](http://docs.aws.amazon.com/it_it/quick/latest/userguide/images/in-function-with-ifelse.png)