Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
startsWith
startsWith evalúa si la expresión comienza por la subcadena que especifique. Si la expresión comienza por la subcadena, startsWith devuelve true y, en caso contrario, devuelve false.
Sintaxis
startsWith(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 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 startsWith New.
startsWith(state_nm,"New")
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 startsWith new.
startsWith(state_nm,"new", 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 startsWith 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 comienza por New.
sumIf(Sales,startsWith(state_nm,"New"))
NO contiene un ejemplo
El operador condicional NOT se puede usar para evaluar si la expresión no comienza por la subcadena especificada.
NOT(startsWith(state_nm,"New"))
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.
startsWith(state_nm, toString(5) )
