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.

Example

See Predicate Function, matches

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

• Cause: More information: Exceptions in Regular Expressions.
  Runtime Error: REGEX_TOO_COMPLEX
  

CX_SY_STRG_PAR_VAL

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