2022.2

Table Of Contents
Notethatthesmallertheareais,thefasterthesearchis.Soifyouknowthattheword"text"iswithin3
inchesfromtheleftedgeofthepage,providethefollowing:
data.find("text", 0, 76.2); //76.2mm = 3*25.4 mm
Thereturnvalueofthefunctionis:
Left=26,76, Top=149.77, Right=40,700001, Bottom=154.840302
Thesevaluesrepresentthesizeoftherectanglethatenclosesthestringinfull,inmillimetersrelativeto
theupperleftcornerofthecurrentpage.
findRegExp()
Findsthefirstoccurrenceofastringthatmatchesthegivenregularexpressionpattern,startingfrom
thecurrentposition.
findRegExp(regexpToFind, flags, leftConstraint, rightConstraint): rectValueText)
Findsthefirstmatchforagivenregularexpressionpatternstartingfromthecurrentposition.Regular
expressionflags(i,s,L,m,u,U,d)arespecifiedintheflagsparameter.Thesearchcanbeconstrainedto
averticalcolumnofcharacterslocatedbetweentheleftandrightconstraint,eachexpressedinchar-
acters(inatextfile)ormillimeters(inaPDFfile).
Partialmatchesarenotallowed.Theentirematchfortheregularexpressionpatternmustbefound
betweenthetwoconstraints.
Themethodreturnsnulliftheregularexpressionproducesnomatch.Otherwiseitreturnsa
RectValueTextobject,containingtheLeft,Top,RightandBottomcoordinates-expressedinchar-
acters(inatextfile)ormillimeters(inaPDFfile),relativetotheupperleftcornerofthecurrentpage-of
thesmallestpossiblerectanglethatcompletelyenclosesthefirstmatchfortheregularexpression.
Note: Callingthismethoddoesnotmovethecurrentpositiontothelocationwherethematch
occurred.Thisallowsyoutousethemethodasalook-aheadfunctionwithoutdisruptingtherest
ofthedatamappingworkflow.
Note: Thisfunctionevaluatestheregularexpressionpatternforeachindividualline.Multilinereg-
ularexpressionpatterns,i.e.,patternswithtokenssuchaslineendtokens(\n)arenotsupported.
regexpToFind
Regularexpressionpatterntofind.
flags
Page 387