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à.
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.
- string-comparison-mode
-
(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) )
