PCRE2CodeMBS.Constructor   Private

PCRE2CodeMBS.Copy(withTables as boolean = false) as PCRE2CodeMBS

Without a subsequent call to JITCompile(), the copy can be used only for non-JIT matching. The pointer to the character tables is copied, not the tables themselves (unless withTables is true).

PCRE2CodeMBS.Infos as PCRE2CodeInfoMBS()

Var Compiler As New PCRE2CompilerMBS

// pattern with callout
compiler.Pattern = "A(?C3)B"

Var code As PCRE2CodeMBS = Compiler.Compile
Var codeInfo() As PCRE2CodeInfoMBS = code.Infos

break // look into debugger

Useful to debug the pattern.

PCRE2CodeMBS.JITCompile(Flags as Integer = 1)

If the just-in-time compiler is available, further processes a compiled pattern into machine code that executes much faster than the Match() interpretive matching function.

Some examples using this method:

• /RegEx/PCRE2/PCRE2 Speed Test

PCRE2CodeMBS.Match(Text as String, matchData as PCRE2MatchDataMBS, StartOffsetCharacters as Integer = 0, MatchContext as PCRE2MatchContextMBS = nil) as Integer

Var Compiler As New PCRE2CompilerMBS

// find numbers
compiler.Pattern = "(\d+)([$€£]?)"

Var code As PCRE2CodeMBS = Compiler.Compile

// prepare reuable match object
Var Match As New PCRE2MatchDataMBS(code)

// now run a match
Var Text As String = "Täst 1234€ Case"
Var n As Integer = code.Match(Text, match)

// get result found
Var TotalSubString As String = match.SubString(0)
Var SubString1 As String = match.SubString(1)
Var SubString2 As String = match.SubString(2)

break // see debugger

It returns offsets to what it has matched and to captured substrings via the matchData object. The return from Match() is one more than the highest numbered capturing pair that has been set (for example, 1 if there are no captures), zero if the vector of offsets is too small.
Raises exception in case of error.

A match context is needed only if you want to:

• Set up a callout function
• Set a matching offset limit
• Change the heap memory limit
• Change the backtracking match limit
• Change the backtracking depth limit
• Set custom memory management specifically for the match

See also:

• Match(Text as String, StartOffsetCharacters as Integer = 0, MatchContext as PCRE2MatchContextMBS = nil) as PCRE2MatchDataMBS

PCRE2CodeMBS.Match(Text as String, StartOffsetCharacters as Integer = 0, MatchContext as PCRE2MatchContextMBS = nil) as PCRE2MatchDataMBS

// Compile a pattern
Var Compiler As New PCRE2CompilerMBS
compiler.Pattern = "(\d+)([$€£]?)"
Var code As PCRE2CodeMBS = Compiler.Compile

// now run a match
Var Match1 As PCRE2MatchDataMBS = code.Match("abc") // -> nil as not found
Var Match2 As PCRE2MatchDataMBS = code.Match("Täst 1234€ Case")

MessageBox match2.SubString(0)

Performs match and returns the new PCRE2MatchDataMBS object.
Returns nil in case nothing is found.

See also:

• Match(Text as String, matchData as PCRE2MatchDataMBS, StartOffsetCharacters as Integer = 0, MatchContext as PCRE2MatchContextMBS = nil) as Integer

PCRE2CodeMBS.MatchAll(Text as String, StartOffsetCharacters as Integer = 0, MatchContext as PCRE2MatchContextMBS = nil) as PCRE2MatchDataMBS()

// Compile a pattern
Var Compiler As New PCRE2CompilerMBS
compiler.Pattern = "(\d)"
Var code As PCRE2CodeMBS = Compiler.Compile

// now run a match
Var Matches() As PCRE2MatchDataMBS = code.MatchAll("Täst 1234€ Case")

Var SubString0 As String = matches(0).SubString(0)
Var SubString1 As String = matches(1).SubString(0)
Var SubString2 As String = matches(2).SubString(0)
Var SubString3 As String = matches(3).SubString(0)

// see 4 results in debugger
Break

This does a loop to go over text from start to end to match the pattern as often as it fits.
We try to avoid endless loops.

Returns an array with PCRE2MatchDataMBS objects, one for each match.

Some examples using this method:

• /RegEx/PCRE2/PCRE2 Speed Test

PCRE2CodeMBS.Matches(Text as String, StartOffsetCharacters as Integer = 0, MatchContext as PCRE2MatchContextMBS = nil) as PCRE2IteratorMBS

Var rx As New PCRE2CompilerMBS
rx.CaseLess = True
rx.DotAll = False
rx.Ungreedy = False
rx.NewLine = rx.kNewLineAnyCRLF
rx.Multiline = True
rx.Pattern = kMarkerPattern

Var code As PCRE2CodeMBS = rx.Compile
Var foundCount as integer

for each MatchData as PCRE2MatchDataMBS in code.Matches(TestString, 0)
  foundCount = foundCount + 1
next

Returns the iterator, so you can use it with for each loop.
May raie an error if something goes wrong.

PCRE2CodeMBS.Names as String()

Var Compiler As New PCRE2CompilerMBS

// find numbers
compiler.Pattern = "(?<AA>\d+)"

Var code As PCRE2CodeMBS = Compiler.Compile
Var names() As String = code.Names

Break // see debugger

PCRE2CodeMBS.SerializeEncode as String

// Compile a pattern
Var Compiler As New PCRE2CompilerMBS
compiler.Pattern = "(\d+)([$€£]?)"
Var code1 As PCRE2CodeMBS = Compiler.Compile

// store somewhere compiled
Var data As String = code1.SerializeEncode

// later rebuild it
Var code2 As PCRE2CodeMBS = PCRE2CodeMBS.SerializeDecode(data)

// prepare reuable match object
Var Match As New PCRE2MatchDataMBS(code2)

// now run a match
Var Text As String = "Täst 1234€ Case"
Var Found As Integer = code2.Match(Text, match)

MessageBox match.SubString(0)

Note that this is not an abstract format like Java or .NET. Conversion of the byte stream back into usable compiled patterns can only happen on a host that is running the same version of PCRE2, with the same code unit width, and the host must also have the same endianness, pointer width and size_t type.

PCRE2CodeMBS.Substitute(Text as String, Replacement as String, matchData as PCRE2MatchDataMBS = nil, StartOffsetCharacters as Integer = 0, MatchContext as PCRE2MatchContextMBS = nil) as String

// Compile a pattern
Var Compiler As New PCRE2CompilerMBS
compiler.Pattern = "(\d)"
Var code As PCRE2CodeMBS = Compiler.Compile

// replace all
code.SubstituteGlobal = True

// we replace all and duplicate all digits here:
Var newText As String = code.Substitute("Täst 1234€ Case", "$1$1")

Break // see result in debugger

It then makes a copy of the subject, substituting a replacement string for what was matched.

Text: The subject string
Replacement: the replacement string
matchData: The match data block, or is nil if you don't need the result.
StartOffsetCharacters: Offset in the subject at which to start matching.
MatchContext: A match context, or nil.

A match data block is needed only if you want to inspect the data from the final match that is returned in that block or if SubstituteMatched is set. A match context is needed only if you want to:

• Set up a callout function
• Set a matching offset limit
• Change the backtracking match limit
• Change the backtracking depth limit
• Set custom memory management in the match context

PCRE2CodeMBS.SubstringNumberFromName(Name as String) as Integer

If the string is not found, you receive a negative value.
For other errors, we raise an exception.