endsWith
endsWith valuta se l'espressione termina con una sottostringa specificata dall'utente. Se l'espressione termina con la sottostringa, endsWith restituisce true, altrimenti restituisce false.
Sintassi
endsWith(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 con distinzione tra maiuscole e minuscole valuta se state_nm endsWith "York".
endsWith(state_nm,"York")
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 endsWith "york".
endsWith(state_nm,"york", 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 endsWith 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.
Il seguente esempio somma Sales solo se state_nm termina con "York".
sumIf(Sales,endsWith(state_nm,"York"))
NON contiene esempi
L'operatore NOT condizionale può essere utilizzato per valutare se l'espressione non inizia con la sottostringa specificata.
NOT(endsWith(state_nm,"York"))
Esempio di utilizzo dei valori numerici
I valori numerici possono essere utilizzati negli argomenti di espressioni o sottostringhe applicando la funzione toString.
endsWith(state_nm, toString(5) )
