CL_ABAP_MATCHER - Regular Expressions

ROGBILLS - Synchronize billing plans   RFUMSV00 - Advance Return for Tax on Sales/Purchases  
This documentation is copyright by SAP AG.

Functionality

For editing regularexpressions, the classes CL_ABAP_REGEX andCL_ABAP_MATCHER are available.

When an instance of the class CL_ABAP_MATCHER is created, a regular expression is linked with the characterstring or table to be processed. The object stores the result and the current status of the text processing and can be queried using different get methods.

The following methods are provided for text search and text replacement:

• constructor(regex, {text | table})

• find_next(success)

• find_all(matches)

• match(success)

• replace_next(newtext, success)

• replace_found(newtext, success)

• replace_all(newtext, success)

The status and result of the find or replace operation can be queried using the following methods:

• get_match(match)

• get_submatch([index], submatch)

• get_line(line)

• get_offset([index], offset)

• get_length([index], length)

A number of static methods provide assistance when working with static methods in some common situations:

• create(pattern, {text |table}, [ignore_case], [no_submatches], [simple_regex], matcher)

• contains(pattern, {text |table}, [ignore_case], [no_submatches], [simple_regex], success)

• matches(pattern, {text |table}, [ignore_case], [no_submatches], [simple_regex], success)

• get_object(matcher)
  
  

Exceptions

When an error occurs, an exception of error class CX_SY_MATCHER is triggered according to the relevant text parameter:

• INVALID_ARGUMENTS
  The specifications of the text to be scanned are invalid.

• NO_CURRENT_MATCH
  A text replacement or a result query were executed without a valid match.

• INVALID_SUBMATCH
  An access was executed to a subgroup that does not exist.

• INVALID_MATCH_OPERATION
  You tried to use the match method for an internal table.

Further information:

Regular Expressions

BAL_S_LOG - Application Log: Log header data   ROGBILLS - Synchronize billing plans  
This documentation is copyright by SAP AG.


Length: 4559 Date: 20120526 Time: 082035     triton ( 78 ms )