String.beginsWith(matchStr)

Operator Type:

Operator Scope of Action:

Operator Purpose:

Data Type Returned:

Operator First Added:

Operator in Current Baseline:

Operator Last Altered:

Function [other Function type actions]

Item [operators of similar scope]

Data manipulation [other Data manipulation operators]

boolean test

v6.4.0

Baseline

As at baseline

String.beginsWith(matchStr)

String.beginsWith() returns Boolean true if the chained string begins with the literal string matchStr. Note that matchStr cannot be a regular expression, only literal string values are allowed.

For example, if $MyString is "I do not like green eggs and ham":

$MyString.beginsWith("I do") returns true

$MyString.beginsWith("Hello") returns false

Also, with string literals:

("There are gentlemen now abed.").beginsWith("There are") returns true

("There are gentlemen now abed.").beginsWith("Hello") returns false

This operator searches for literal strings, not regular expressions. Matches are case sensitive

("There are gentlemen now abed.").beginsWith("there are") returns false

See also String.endsWith(). If you need to search a String for a regular expression, use String.contains().

See also—notes linking to here:

String.endsWith(matchStr)