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_SENSITIVEcuando está en blanco. -
Tipo de devolución
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) )
