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_SENSITIVE
quando è vuoto. -
Tipo restituito
Booleano
Esempi
Esempio predefinito che distingue tra maiuscole e minuscole
Il seguente esempio, con 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, senza 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 startsWith
funzione può essere utilizzata come istruzione condizionale all'interno delle seguenti funzioni If: avgIf, minIf, distinct_,countIf,, countIf,, maxIfmedianIfstdevIf, stdevpIfe. sumIfvarIfvarpIf
L'esempio seguente somma Sales
solo se state_nm inizia con New
.
sumIf(
Sales
,startsWith(state_nm
,"New"
))
Contiene un esempio NOT
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
) )