endsWith

endsWith evalúa si la expresión finaliza con la subcadena que especifique. Si la expresión finaliza con la subcadena, endsWith devuelve true y, en caso contrario, devuelve false.

Sintaxis

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

Argumentos

expresión

La expresión debe ser una cadena. Puede ser el nombre de un campo que utiliza el tipo de datos de cadena, un valor literal como '12 Main Street' o una llamada a otra función que genera una cadena.

subcadena

El conjunto de caracteres que se comparan con la expresión. La subcadena puede aparecer una o más veces en la expresión.

string-comparison-mode

(Opcional) Especifica el modo de comparación de cadenas que se va a utilizar:

• CASE_SENSITIVE: las comparaciones de cadenas distinguen entre mayúsculas y minúsculas.

• CASE_INSENSITIVE: las comparaciones de cadenas no distinguen entre mayúsculas y minúsculas.

Este valor se establece de forma predeterminada en CASE_SENSITIVE cuando está en blanco.

Tipo de retorno

Booleano

Ejemplos

Ejemplo de distinción entre mayúsculas y minúsculas predeterminado

En el siguiente ejemplo, que distingue entre mayúsculas y minúsculas, se evalúa si state_nm endsWith "York".

endsWith(state_nm, "York")

Los siguientes son los valores de los campos.

New York
new york

Para estos valores de campo, se devuelven los siguientes valores.

true
false

Ejemplo que no distingue entre mayúsculas y minúsculas

En el siguiente ejemplo, que no distingue entre mayúsculas y minúsculas, se evalúa si state_nm endsWith "york".

endsWith(state_nm, "york", CASE_INSENSITIVE)

Los siguientes son los valores de los campos.

New York
new york

Para estos valores de campo, se devuelven los siguientes valores.

true
true

Ejemplo con instrucciones condicionales

La función endsWith se puede utilizar como instrucción condicional en las siguientes funciones If: avgIf, minIf, distinct_countIf, countIf, maxIf, medianIf, stdevIf, stdevpIf, sumIf, varIf y varpIf.

El siguiente ejemplo solo suma Sales si state_nm finaliza con "York".

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

NO contiene un ejemplo

El operador condicional NOT se puede usar para evaluar si la expresión no comienza por la subcadena especificada.

NOT(endsWith(state_nm, "York"))

Ejemplo de uso de valores numéricos

Los valores numéricos se pueden utilizar en los argumentos de la expresión o de la subcadena mediante la aplicación de la función toString.

endsWith(state_nm, toString(5) )