

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

`in` bewertet, ob ein Ausdruck in einer literalen Liste existiert. Wenn die Liste den Ausdruck enthält, wird wahr zurückgegeben, andernfalls falsch. `in` unterscheidet bei Eingaben vom Typ Zeichenfolge zwischen Groß- und Kleinschreibung.

`in` akzeptiert zwei Arten von literalen Listen: eine ist eine manuell eingegebene Liste und die andere ist ein [mehrwertiger Parameter.](https://docs.aws.amazon.com/quicksight/latest/user/parameters-in-quicksight.html)

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

Verwenden einer manuell eingegebenen Liste:

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

Verwendung eines mehrwertigen Parameters:

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

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

 *expression*   
Der Ausdruck, der mit den Elementen in der literalen Liste verglichen werden soll. Dabei kann es sich um einen Feldnamen wie `address`, einen literalen Wert wie „**Unknown**„, einen Einzelwertparameter oder einen Aufruf einer anderen Skalarfunktion handeln — vorausgesetzt, es handelt sich bei dieser Funktion nicht um eine Aggregatfunktion oder eine Tabellenberechnung.

 *Literale Liste*   
(erforderlich) Dies kann eine manuell eingegebene Liste oder ein mehrwertiger Parameter sein. Dieses Argument akzeptiert bis zu 5.000 Elemente. Bei einer direkten Abfrage an eine Datenquelle eines Drittanbieters, beispielsweise Oracle oder Teradata, kann die Einschränkung jedoch geringer sein.  
+ ***manuell eingegebene Liste*** — Ein oder mehrere literale Werte in einer Liste, die mit dem Ausdruck verglichen werden sollen. Die Liste sollte in eckige Klammern gesetzt werden. Alle zu vergleichenden Literale müssen denselben Datentyp wie der Ausdruck haben. 
+ ***Mehrwertiger Parameter*** — Ein vordefinierter mehrwertiger Parameter, der als literale Liste übergeben wird. Der mehrwertige Parameter muss denselben Datentyp wie der Ausdruck haben. 


## Rückgabetyp
<a name="in-function-return-type"></a>

Boolesch „TRUE“/„FALSE“

## Beispiel mit einer statischen Liste
<a name="in-function-example-static-list"></a>

Im folgenden Beispiel wird das Feld `origin_state_name` nach Werten in einer Zeichenfolgenliste ausgewertet. Beim Vergleich von Zeichenfolgeneingaben unterstützt `in` nur den Vergleich zwischen Groß- und Kleinschreibung.

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

Das Feld enthält folgende Werte.

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

Für diese Feldwerte werden die folgenden Ergebniswerte zurückgegeben.

```
false
        false
        true
```

Der dritte Rückgabewert ist true, da nur „Texas“ einer der eingeschlossenen Werte ist.

Im folgenden Beispiel wird das Feld `fl_date` nach Werten in einer Zeichenfolgenliste ausgewertet. Um dem Typ zu entsprechen, wird `toString` verwendet, um den Datumstyp in den Zeichenfolgentyp umzuwandeln.

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

![\[Ein Image der Ergebnisse des Funktionsbeispiels in Tabellenform.\]](http://docs.aws.amazon.com/de_de/quick/latest/userguide/images/in-function-example-manual-list.png)


Literale und NULL-Werte werden im Ausdrucksargument unterstützt, um mit den Literalen in der Liste verglichen zu werden. In den beiden folgenden Beispielen wird eine neue Spalte mit TRUE-Werten generiert. 

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

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

## Beispiel mit mehrwertigem Parameter
<a name="in-function-example-mutivalue-parameter"></a>

Nehmen wir an, ein Autor erstellt einen [mehrwertigen Parameter](https://docs.aws.amazon.com/quicksight/latest/user/parameters-in-quicksight.html), der eine Liste aller Staatsnamen enthält. Dann fügt der Autor ein Steuerelement hinzu, mit dem der Leser Werte aus der Liste auswählen kann.

Als Nächstes wählt der Leser drei Werte - „Georgia“, „Ohio“ und „Texas“ - aus dem Dropdownlisten-Steuerelement des Parameters aus. In diesem Fall entspricht der folgende Ausdruck dem ersten Beispiel, in dem diese drei Bundesstaatennamen als literale Liste übergeben werden, die mit dem Feld `original_state_name` verglichen werden soll. 

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

## Beispiel mit `ifelse`
<a name="in-function-example-with-ifelse"></a>

`in` kann als boolescher Wert in andere Funktionen verschachtelt werden. Ein Beispiel ist, dass Autoren jeden Ausdruck in einer Liste auswerten und den gewünschten Wert mithilfe von `in` und `ifelse` zurückgeben können. Im folgenden Beispiel wird ausgewertet, ob sich das `dest_state_name` eines Flug in einer bestimmten Liste von US-Bundesstaaten befindet, und es werden auf der Grundlage des Vergleichs verschiedene Kategorien der Bundesstaaten zurückgegeben.

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

![\[Ein Image der Ergebnisse des Funktionsbeispiels in Tabellenform.\]](http://docs.aws.amazon.com/de_de/quick/latest/userguide/images/in-function-with-ifelse.png)
