endsWith

endsWith avalia se a expressão termina com uma substring especificada por você. Se a expressão terminar com a substring, endsWith retornará true, caso contrário, retornará false.

Sintaxe

endsWith(expression, substring, string-comparison-mode)

Argumentos

expressão

A expressão deve ser uma string. Isso pode ser o nome de um campo que usa o tipo de dados de string, um valor literal, como '12 Main Street', ou uma chamada para outra função que gere uma string.

substring

O conjunto de caracteres a serem comparados com a expressão. A substring pode ocorrer uma ou mais vezes na expressão.

string-comparison-mode

(Opcional) Especifica o modo de comparação de strings a ser usado:

• CASE_SENSITIVE: as comparações de strings diferenciam maiúsculas de minúsculas.

• CASE_INSENSITIVE: as comparações de strings não diferenciam maiúsculas de minúsculas.

Esse valor será padronizado como CASE_SENSITIVE quando for deixado em branco.

Tipo de retorno

Booleano

Exemplos

Exemplo padrão de diferenciação entre maiúsculas e minúsculas

O exemplo a seguir, com distinção entre maiúsculas e minúsculas, avalia se state_nm endsWith "York".

endsWith(state_nm, "York")

A seguir estão os valores de campo especificados.

New York
new york

Para esses valores de campo, os seguintes valores são retornados.

true
false

Exemplo sem distinção entre maiúsculas e minúsculas

O exemplo a seguir, sem distinção entre maiúsculas e minúsculas, avalia se state_nm endsWith "york".

endsWith(state_nm, "york", CASE_INSENSITIVE)

A seguir estão os valores de campo especificados.

New York
new york

Para esses valores de campo, os seguintes valores são retornados.

true
true

Exemplo com declarações condicionais

A função endsWith pode ser usada como a declaração condicional nas seguintes funções IF: avgIf, minIf, distinct_countIf, countIf, maxIf, medianIf, stdevIf, stdevpIf, sumIf, varIf e varpIf.

O exemplo a seguir soma Sales somente se state_nm terminar com "York".

sumIf(Sales,endsWith(state_nm, "York"))

Exemplo does NOT contain

O operador condicional NOT pode ser usado para avaliar se a expressão não começa com a substring especificada.

NOT(endsWith(state_nm, "York"))

Exemplo de uso com valores numéricos

Valores numéricos podem ser usados nos argumentos da expressão ou da substring aplicando a função toString.

endsWith(state_nm, toString(5) )