Regexp_Functions

Purpose

This module provides a non TTCN regular expression handling functions

Module Parameters

Module depends on

Current Owner

Last Review Date

Summary

Regexp_Functions	This module provides a non TTCN regular expression handling functions
Functions
f_pcre_regexp	Evaulate a Perl compatible regular expression
f_pcre_regexp	Evaulate a Perl compatible regular expression

Functions

f_pcre_regexp

external function f_pcre_regexp( in charstring instr,

in charstring expression,

in integer groupno ) return charstring

Purpose

Evaulate a Perl compatible regular expression

Parameters

instr	in charstring - string to be matched
expression	in charstring - the pattern
groupno	in inteher - the number of the group to return

Return Value

charstring

the matched substring

Errors

Detailed description

This function returns the substring of the input character string instr, which is the content of n-th group matching to the expression. The expression is a Perl compatible regular expression pattern. The number of the group to be returned is specified by groupno, which shall be a positive integer or zero. Group numbers are assigned by the order of occurrences of the opening bracket of a group and counted starting from 1 by step 1. If the groupno is zero, a substring macthed by the entire pattern is returned. If no substring fulfilling all conditions (i.e. pattern and group number) is found within the input string, an empty string is returned.

f_pcre_regexp

type record of charstring charstring_list external function f_pcre_regexp_list(

in charstring instr,

in charstring expression

) return charstring_list

Purpose

Evaulate a Perl compatible regular expression

Parameters

instr	in charstring - string to be matched
expression	in charstring - the pattern

Return Value

record of charstring

the matched substrings

Errors

Detailed description

This function returns the list of the substring of the input character string instr, which is the content of n-th group matching to the expression. The expression is a Perl compatible regular expression pattern. Group numbers are assigned by the order of occurrences of the opening bracket of a group and counted starting from 1 by step 1. If no substring fulfilling all conditions is found within the input string, an empty record of is returned.