StrRegexExecute Function

Action

Executes the compiled regular expression on the string argument.

Include file

Kernel.bdh

Syntax

StrRegexExecute( in    hRegex  : number,
                 inout sSource : string ): boolean;

Return value

true if a match of the regular expression in the string sSource could be found.
false on errors or if no match could be found. Use GetLastError and GetErrorMsg to query for more information.

Parameter	Description
hRegex	Valid handle to a compiled regular expression. This handle must have been generated with a previous call to StrRegexCompile.
sSource	String to be matched by the regular expression

Example

dcltrans
  transaction TMain
  var
    hRegex                   : number;
    sRegex, sSource, sTarget : string;
    match                    : boolean;
  begin
    sSource := "SessionIDTest.asp?SessionID=SID8:44:43&amp;"
               "Param2=Value2";
    sRegex := "SessionID=\(SID[0-9:]+\)";
    write("source = "+sSource); writeln;
    write("regex = "+sRegex); writeln;
    StrRegexCompile(hRegex, sRegex);
    match := StrRegexExecute(hRegex, sSource);
 
    if match then
      StrRegexSubst(hRegex, "\1", sTarget, STRING_COMPLETE);
      write("match: "+sTarget); writeln;
    else
      write("no match"); writeln;
    end;

    StrRegexClose(hRegex);
  end TMain;

Output

source = SessionIDTest.asp?
SessionID=SID8:44:43&amp;Param2=Value2
regex = SessionID=\(SID[0-9:]+\)
match: SID8:44:43

Sample scripts

WebRegularExpressions01.bdf