ExecPos Method

Applies to TestComplete 15.47, last modified on January 20, 2023

Description

The RegExpr.ExecPos method searches the input string starting from the AOffset position for the text that matches the regular expression pattern. To get a portion of the text that matches the pattern use the Match property.

Declaration

RegExprObj.ExecPos(AOffset)

RegExprObj An expression, variable or parameter that specifies a reference to a RegExpr object
AOffset [in]    Optional    Integer Default value: 1   
Result Boolean

Applies To

The method is applied to the following object:

Parameters

The method has the following parameter:

AOffset

An integer specifying the input string character position where the search operation started.

Result Value

Returns True if the text matching the expression was found and False otherwise.

Remarks

You should initialize the Expression property with the regular expression and the InputString property (explicitly or implicitly via previous Exec call) with the input string before calling the ExecPos method, otherwise an error occurs.

Example

The following example demonstrates how you can use the RegExpr.ExecPos method to specify whether the input string that starts from the specified position contains the text that matches the pattern.

DelphiScript

procedure ExecPosSample();
var
  MyRegExpr: OleVariant;
  Input, Expr: string;
begin

  MyRegExpr := HISUtils.RegExpr;
  Input := 'TestComplete project suite files have the .pjs extension.';
  // This expression specifies the extension pattern
  Expr := '(\.[\w]+)';
  MyRegExpr.InputString := Input;
  MyRegExpr.Expression : = Expr;

  // Checks whether the input string contains matching text after the specified position
  if MyRegExpr.ExecPos(40) then
    Log.Message('The matching text is found after the specified position')
  else
    Log.Message('No matching text was found after the specified position');

end;

See Also

Using Regular Expressions in Scripts
Using Regular Expressions in Scripts
Expression Property
InputString Property
Match Property
Exec Method
ExecNext Method

Highlight search results