SURVO MM Help System (web edition)

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

  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=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 

More information on Survo from
Copyright © Survo Systems 2001-2012.