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. # contains `contains` bewertet, ob die von Ihnen angegebene Teilzeichenfolge in einem Ausdruck existiert. Wenn der Ausdruck die Teilzeichenfolge enthält, gibt contains true zurück, andernfalls wird false zurückgegeben. ## Syntax ``` contains(expression, substring, string-comparison-mode) ``` ## Argumente *expression* Der Ausdruck muss eine Zeichenfolge sein. Es kann der Name eines Felds sein, das den Datentyp "string" verwendet, ein literaler Wert wie **'12 Main Street'** oder der Aufruf einer Funktion, die eine Zeichenfolge ausgibt. *substring* Der Zeichensatz, der mit dem *Ausdruck* verglichen werden soll. Die Teilzeichenfolge kann sowohl einmal als auch mehrmals im *Ausdruck* enthalten sein. *string-comparison-mode* (Optional) Gibt den zu verwendenden Zeichenfolgenvergleichsmodus an: + `CASE_SENSITIVE` - Bei Zeichenfolgenvergleichen wird zwischen Groß- und Kleinschreibung unterschieden. + `CASE_INSENSITIVE` - Bei Zeichenfolgenvergleichen wird nicht zwischen Groß- und Kleinschreibung unterschieden. Dieser Wert wird standardmäßig auf `CASE_SENSITIVE` eingestellt, wenn er leer ist. ## Rückgabetyp Boolesch ## Beispiele ### Standardbeispiel für Groß- und Kleinschreibung Das folgende Beispiel, bei dem Groß- und Kleinschreibung beachtet wird, bewertet, ob `state_nm` **New** enthält. ``` contains(state_nm, "New") ``` Das Feld enthält folgende Werte. ``` New York new york ``` Für diese Feldwerte werden die folgenden Ergebniswerte zurückgegeben. ``` true false ``` ### Beispiel ohne Unterscheidung von Groß- und Kleinschreibung Das folgende Beispiel ohne Berücksichtigung der Groß- und Kleinschreibung bewertet, ob `state_nm` **new** enthält. ``` contains(state_nm, "new", CASE_INSENSITIVE) ``` Das Feld enthält folgende Werte. ``` New York new york ``` Für diese Feldwerte werden die folgenden Ergebniswerte zurückgegeben. ``` true true ``` ### Beispiel mit bedingten Anweisungen Die Funktion contains kann als bedingte Anweisung in den folgenden If-Funktionen verwendet werden: [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) und [varpIf](https://docs.aws.amazon.com/quicksight/latest/user/varpIf-function.html). Das folgende Beispiel summiert `Sales` nur, wenn `state_nm` **New** enthält. ``` sumIf(Sales,contains(state_nm, "New")) ``` ### Enthält KEIN Beispiel Der konditionale `NOT`-Operator kann verwendet werden, um auszuwerten, ob der Ausdruck die angegebene Teilzeichenfolge nicht enthält. ``` NOT(contains(state_nm, "New")) ``` ### Beispiel mit numerischen Werten Numerische Werte können in den Ausdrucks- oder Teilzeichenfolgenargumenten durch Anwendung der `toString`-Funktion verwendet werden. ``` contains(state_nm, toString(5) ) ```