Show/Hide Toolbars

RiverSoftAVG Products Help

Encapsulates a regular expression search engine. This object will build a state machine from a regular expression, which can then be matched againsts strings. The regular expression search engine supports:

• '?' zero or one

• '*' zero or more

• '+' one or more

• '|' Choice

• '^' Anchor at beginning (match must start at first position

• '$' Anchor at end (match #13)

• '-' range, e.g., 0-9

• '.' any single char

alert_cautionWarning

This engine only works with ansi strings, not Unicode.

Namespace: GRegularExpression

TPersistent
  GRegularExpression.TGRegularExpression
 

Delphi

type 
  TGRegularExpression = class(TPersistent) 
  end;  
 

 

Name

Description

public constructor

Create(TRegExString)

Creates the regular expression engine and optionally builds the regular expression state machine

Top

 

Name

Description

protected property

AnchorEnd

Represents property AnchorEnd.

protected property

AnchorStart

Represents property AnchorStart.

published property

CaseSensitive

Specifies whether the regular expression should worry about case-sensitivity when matching input strings to the regular expression state machine.

published property

Expression

Specifies the regular expression to match strings against.

protected property

Index

Represents property Index.

public property

MaxExamples

Specifies the number of examples to generate every time the Examples function is called.

protected property

StartState

Represents property StartState.

protected property

States

Represents property States.

Top

 

Name

Description

protected method

AddState(TRegExMatchType,TRegExChar,TCharSet,Integer,Integer,Boolean)

Represents method AddState(TRegExMatchType,TRegExChar,TCharSet,Integer,Integer,Boolean).

public method

Assign(TPersistent)

Represents method Assign(TPersistent).

public method

ExactMatch(TRegExString)

Matches the input text against the current regular expression state machine. The Text must match the regular expression from the very first character. Returns true if the text matches the regular expression.

noteNote

If the regular expression is empty (Expression = ''), the method will always return false.

public method

Examples

Overloaded. Returns a string array of example strings that match the regular expression. The size of the string array is specified by the   MaxExamples property.

protected method

Examples(TRegExString,Integer,TRXIntegerArray,TRXStringArray)

Overloaded. Represents method Examples(TRegExString,Integer,TRXIntegerArray,TRXStringArray).

public method

Match(TRegExString,Boolean)

Overloaded. Returns the index in the Text that matches the Regular Expression or 0 if no match found.

noteNote

The regular expression engine uses 1-indexed strings, not the new 0-indexed strings.

noteNote

If the regular expression is empty (Expression = ''), the method will always return 0.

public method

Match(TRegExString,Integer,Boolean)

Overloaded. Returns the index in the Text that matches the Regular Expression or 0 if no match found. The Len parameter will equal the number of characters in the Text that match the regular expression.

noteNote

The regular expression engine uses 1-indexed strings, not the new 0-indexed strings.

noteNote

If the regular expression is empty (Expression = ''), the method will always return 0.

public method

Match(TRegExString,Integer,Integer,Boolean)

Overloaded. Returns the index in the Text that matches the Regular Expression or 0 if no match found. The Len parameter will equal the number of characters in the Text that match the regular expression.

noteNote

The regular expression engine uses 1-indexed strings, not the new 0-indexed strings.

noteNote

If the regular expression is empty (Expression = ''), the method will always return 0.

protected method

MatchSubString(TRegExString,Integer,Integer,Boolean)

Represents method MatchSubString(TRegExString,Integer,Integer,Boolean).

protected method

OptimizeStates

Represents method OptimizeStates.

protected method

ParseAnchorExpression

Represents method ParseAnchorExpression.

protected method

ParseAtom

Represents method ParseAtom.

protected method

ParseChar

Represents method ParseChar.

protected method

ParseCharSet

Represents method ParseCharSet.

protected method

ParseCharSetRange

Represents method ParseCharSetRange.

protected method

ParseCSChar

Represents method ParseCSChar.

protected method

ParseExpr

Represents method ParseExpr.

public method

ParseExpression

Overloaded. Parse and build the regular expression state machine from the GRegularExpression.TGRegularExpression.Expression property.

public method

ParseExpression(TRegExString)

Overloaded. Parse and build the regular expression state machine from input expression parameter. This method will set the GRegularExpression.TGRegularExpression.Expression property.

protected method

ParseFactor

Represents method ParseFactor.

protected method

ParseTerm

Represents method ParseTerm.

Top

Matches any sequence of a and b that end with ab (ab, aab, aabaaab, ababbaaaaaab, bbbab)
(a|b)*ab
 
Match any 3 day month
(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)
 
Match any number
(\+|\-)?([0-9]+|[0-9]+\.?[0-9]*|[0-9]*\.?[0-9]+)
 
Match any integer
(\+|\-)?[0-9]+
 
Match any month integer 1-12
([1-9]|0[1-9])|1[0-2])
 
Match any vowel
[aeiou]
 
Match 4 digit year and optional month
[0-9][0-9][0-9][0-9](\-?(0[1-9]|1[0-2])Z?)?
 
Match ISO 8601 Date and Time
[0-9][0-9][0-9][0-9]((\-?(0[1-9]|1[0-2]))(\-?([0-2][0-9]|3[0-1]))?)?((T| +)([0-1][0-9]|2[0-3])\:?([0-5][0-9])?\:?([0-5][0-9])?(Z|(\+|\-)([0-1][0-9]|2[0-3])\:?([0-5][0-9])?)?)?
 

Reference

•Expressiion

•GRegularExpression.TGRegularExpression.ParseExpression

•GRegularExpression.TGRegularExpression.Match(TRegExString,Integer,Integer,Boolean)

•GRegularExpression.TGRegularExpression.ExactMatch(TRegExString)

•GRegularExpression

RiverSoftAVG Products Help © 1996-2016 Thomas G. Grubb