Skip to content

ABAP Keyword Documentation →  ABAP - Reference →  Program Flow →  Expressions and Functions for Logical Expressions →  Logical Functions →  Predicate Functions →  Predicate functions for character-like arguments 

matches - Predicate Function

Other versions: 7.31 | 7.40 | 7.54

Syntax


... matches( val = text regex = regex
[case = case] 
             [off = off] [len = len] ) ...

Effect

The predicate function matches compares a search range of the argument text, defined using off and len, with the regular expression specified in regex. A corresponding logical value is returned. The return value is true when the whole search range matches the regular expression. The comparison is case-sensitive by default, but this can be overridden using the parameter case.


Note

The match function match can be used to return a subfield that matches a regular expression.


Exceptions


Catchable Exceptions

CX_SY_RANGE_OUT_OF_BOUNDS

  • Cause: Illegal offset or length specification in the off and len.
    Runtime Error: STRING_OFFSET_TOO_LARGE

CX_SY_REGEX_TOO_COMPLEX

CX_SY_STRG_PAR_VAL

  • Cause: Regular expression in regex is empty.
    Runtime Error: STRG_ILLEGAL_PAR