Navigation: ABC Library Reference > ASCIISearchClass > AsciiSearchClass Methods >====== Setup (set search constraints)  ====== |    |
Setup( constraints [, startline] )
| Setup | Sets the search constraints. |
| constraints | The label of a structure containing the search constraints. The structure must have the same structure as the FindGroup GROUP declared in ABASCII.INC. |
| startline | The offset or position of the line at which to begin the search, typically the current line position. If omitted, startline defaults to one (1). |
The Setup method sets the search constraints. The AsciiSearchClass object applies the constraints when searching the text file.
Implementation:
The ABC Library does not call the Setup method. The Setup method is provided so you can do custom searches outside the normal AsciiViewerClass process (without using the Ask method).
The Next method applies the search constraints set by the Setup method. The constraints include the text to search for, the direction in which to search, and whether or not the search is case sensitive.
The FindGroup GROUP is declared in ABASCII.INC as follows:
FindGroup GROUP,TYPE
What PSTRING(64) !text to look for
MatchCase BYTE !case sensitive?
Direction STRING(4) !either 'Up ' or 'Down'
END
Example:
MyAsciiSearchClass.Ask PROCEDURE
Constraints LIKE(FindGroup)
CODE
Constraints.MatchCase = False !never case sensitive
Constraints.Direction = 'Down' !always search downward
!prompt end user for search value
SELF.Setup(Constraints,StartLine) !set search constraints
SELF.LineCounter=SELF.Next() !execute search
IF SELF.LineCounter
!set to next line containing search value:
SELF.FileMgr.SetLine(SELF.LineCounter)
ELSE
MESSAGE(&CLIP(SELF.Constraints.What)&''' not found.')
END