SEARCH <words> / K.Vehkalahti
searches the given <words> from text files and edit files. The default
behaviour can be modified by various specifications, which are described
on the following pages.
By default
- all files (*.*) from the current path are scanned
- actual search is aimed at text files and Survo edit field files
- only the first match on a line counts
- matching is case sensitive, i.e. uppercase and lowercase are not same
- search is paused after every match unless ESC is pressed
- SHOW commands with the filename and the line number are written
in the edit field starting at line CUR+1.
There is another desktop operation (see WHERE?), which searches the
given file(s) by their name.
Specifications of SEARCH are:
FILES=<filespec> Only files matching <filespec> are scanned.
Examples: FILES=*.EDT FILES=D:\WRK\JOB*.TXT
FILES=C:\PROJECTS\2003\*.EDT,D:\WRK\JOB*.TXT,E:\*.*
SEARCH=<rules> Modifies the search in various ways. <rules> may be
any combination of following: (separated by commas)
SUBDIRS -> scan also the subdirectories
DETAILED -> show all occurrences on a line
NOCASE -> case independent search: abc = ABC
QUOTED -> trailing spaces are taken into account:
the character string must be given in
quotation marks, e.g. SEARCH " abc XYZ "
FIRST -> exit straight after first match
FILE -> display only the first match of each file
DD -> start DD with the files that matched
COMMENT -> search from the comment line (1) of edit files
SHADOWS -> search from shadow lines of edit files
Specifications of SEARCH (continued):
OUTFILE=<filespec> Output is written to <filespec>. In this case
nothing is written to the edit field.
SHOW=<x> <x>=0 : no SHOW commands in the output.
<x>=1 : SHOW commands in the output (default).
<x>=2 : adds pathname to SHOW commands (default,
if SEARCH=SUBDIRS or FILES includes pathname).
<x>=3 : same than <x>=1 above, but writes the SHOW
commands and comments on distinct lines.
(See sucro /SEARCH which uses this feature!)
<x>=4 : same than <x>=3, but with full pathnames.
(See sucro /HSEARCH which uses this feature!)
<x>=5 : writes the results with the appropriate shadows
when SEARCH=SHADOWS is used.
<x>=6 : same than <x>=5, but with full pathnames.
Specifications of SEARCH (continued):
RUN=1 Search begins immediately in continuous mode.
COLS=C1,C2 Search is restricted to columns C1-C2. Default value
of C2 is C1. C1=0 means the control column in Survo
edit files and the first column in text files.
TUTSTACK=1 The following facts are written to the sucro memory:
- the total number of strings found (W1),
- the number of files scanned (W2),
- the number of lines read (W3).
Exit SEARCH anytime by pressing either F8 (EXIT) or `.' (full stop).
ESC toggles between continuous and stepwise search.
By pressing `S' the current file can be skipped.
Specifications of SEARCH (continued):
DATE=<format> Selects a date format. Valid formats are:
DD.MM.YY DD/MM/YY DDMMYY YYMMDD MM/DD/YY
DD.MM.YYYY DD/MM/YYYY DDMMYYYY YYYYMMDD MM/DD/YYYY
(DD=day, MM=month, YY(YY)=year). Default is DD.MM.YY .
TIME=<format> Selects a time format. Valid formats are:
HH:MM HH:MM:SS HH.MM HH.MM.SS
(HH=hour, MM=minute, SS=second). Default is HH:MM .
The specifications SINCE, BEFORE, MINBYTES and MAXBYTES (see: DD?) can also
be used with SEARCH.
D = More information on desktop operations
Help System (web edition)