Product SiteDocumentation Site

5.4.15.7. caselessMatch


>>-caselessMatch(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. The matching is performed using caseless comparisons. 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 caselessMatch method is useful for efficient string parsing as it does not require new string objects be extracted from the target string.