Returns true if the leftmost set of characters of a column of values matches a pattern. The source value can be any data type, and the pattern can be a , regular expression, or a string.

String literal example:

derive type:single value:STARTSWITH(FullName,'Mr.')

Output: Writes true into a new column if the first three letters of the FullName column value are "Mr.". 

 example:

derive type:single value:STARTSWITH(CustId,`{alpha-numeric}{6}`) as:'validateCustId'

Output: Generates the validateCustId column containing true if the CustId column begins with a six-digit alpha-numeric sequence. Otherwise, the validateCustId column is set to false.

Regular expression pattern example:

set col:Status value:IF(STARTSWITH,phone,/^(\+0?1\s)?\(?\d{3}\)?[\s.-]\d{3}[\s.-]\d{4}$/),'phone - ok','phone - error')

Output: Sets the value in the Status column to phone - ok if the value of the phone column begins with a value that matches a 10-digit U.S. phone number. Otherwise, the Status column is set to phone - error.

derive type:single value:STARTSWITH(column_any,pattern)

ArgumentRequired?Data TypeDescription
column_anyYanyName of the column to be applied to the function
patternYstringPattern or literal expressed as a string describing the pattern to which to match.

column_any

Name of the column to be searched.

Required?Data TypeExample Value
YesColumn referencemyColumn

pattern

, regular expression, or string literal to locate in the values in the specified column.

Required?Data TypeExample Value
YesString`{zip}`

Example - STARTSWITH and ENDSWITH Functions