startsWith
startsWith valuta se l'espressione inizia con una sottostringa specificata dall'utente. Se l'espressione inizia con la sottostringa, startsWith restituisce true, altrimenti restituisce false.
Sintassi
startsWith(expression,substring,string-comparison-mode)
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.
- modalità di confronto tra stringhe
-
(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_SENSITIVEquando è 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 startsWith New.
startsWith(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 con distinzione tra maiuscole e minuscole valuta se state_nm startsWith new.
startsWith(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 startsWith può essere utilizzata come istruzione condizione all'interno delle seguenti funzioni If: avgIf, minIf, distinct_countIf, countIf, maxIf, medianIf, stdevIf, stdevpIf, sumIf, varIf e varpIf.
L'esempio seguente somma Sales solo se state_nm inizia con New.
sumIf(Sales,startsWith(state_nm,"New"))
NON contiene esempi
L'operatore NOT condizionale può essere utilizzato per valutare se l'espressione non inizia con la sottostringa specificata.
NOT(startsWith(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.
startsWith(state_nm, toString(5) )
