Product SiteDocumentation Site

5.4.15.22. match


>>-match(start,other-+----------------------------+-)-------------------><
                     +-,--+---+--+---------+------+
                          +-n-+  +-,length-+

Returns .true ("1") if the characters of the other match the characters of the target buffer beginning at position start. Return .false ("0") if the characters are not a match. start must be a positive whole number less than or equal to the length of the target buffer.
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 buffer.