Option 'a' --> Find All Matches. Normally QTGrep stops scanning a record as soon as a match is found or the end of the record is reached. If the user desires to find all matching strings in all records, then this option must be used. This option forces QTGrep to continue scanning a record even after finding one or more matches until the end of the record is reached. The record containing the matches is normally output for each match. This option is especially useful with either the 'T' option to output tagged strings, the 'M' option to output the match strings instead of the record containing the match string, or the 'D' option to highlight match strings.
Note: In scanning for regular expressions, QTGrep will also find embedded match strings, c.f., the 'e' option, and over-lapping match strings. In searching for keywords, embedded and over-lapping match strings will not be found.
In addition, this option may be used in conjunction with the replace option, 'r'. The replace option is a global option and may only be invoked before all input files are specified. The 'r' option also, by default, 'toggles' this option so that all matching strings are found and replaced. If this option is also invoked with or after the 'r' option, then only the first match in a record will be found and replaced. Embedded or over-lapping match string will not be replaced.
This is a local option and may be turned on or off for separate
files
as desired.
The corresponding long option is: --find-all=(on|off)
Incompatible Options Are:
| W |
Write Compiled Search Patterns |
| Z |
File Preview |