5.1.7.76. match

Returns .true if the characters of the other match the characters of the target string beginning at position start. Returns .false if the characters are not a match. start must be a positive whole number.

If n is specified, the match will be performed starting with character n of other. The default value for n is "1". n must be a positive whole number less than or equal to the length of other.

If length is specified, it defines a substring of other that is used for the match. length must be a positive whole number and the combination of n and length must be a valid substring within the bounds of other.

The match method is useful for efficient string parsing as it does not require new string objects be extracted from the target string.

Example 5.112. String class — match method

"Saturday"~match(6, "day")           -->    1
"Saturday"~match(6, "DAY")           -->    0
"Saturday"~match(6, "Sunday", 4, 3)  -->    1
"Saturday"~match(6, "daytime", 1, 3) -->    1