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. # startsWith `startsWith` wertet aus, ob der Ausdruck mit einer von Ihnen angegebenen Teilzeichenfolge beginnt. Wenn der Ausdruck mit der Teilzeichenfolge beginnt, gibt `startsWith` „True“ zurück, andernfalls „false“. ## Syntax ``` startsWith(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 berücksichtigt wird, bewertet, ob `state_nm` mit **New** startet. ``` startsWith(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 Im folgenden Beispiel ohne Unterscheidung von Groß- und Kleinschreibung wird ausgewertet, ob `state_nm` mit **new** startet. ``` startsWith(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 `startsWith`-Funktion 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\$1nm mit **New** beginnt. ``` sumIf(Sales,startsWith(state_nm, "New")) ``` ### Enthält KEIN Beispiel Der konditionale `NOT`-Operator kann verwendet werden, um auszuwerten, ob der Ausdruck nicht mit der angegebenen Teilzeichenfolge beginnt. ``` NOT(startsWith(state_nm, "New")) ``` ### Beispiel mit numerischen Werten Numerische Werte können in den Ausdrucks- oder Teilzeichenfolgenargumenten durch Anwendung der `toString`-Funktion verwendet werden. ``` startsWith(state_nm, toString(5) ) ```