SHOW - Show Lines Where a String is Found
Syntax
SHOW |
[ search-string ] [ start-column [ end-column ] ] [ FIRST | LAST | NEXT | PREV | ALL ] [ C ] [ Q ] [ T ] [ PREFIX | SUFFIX | WORD | CHAR ] [ line-control-range ] [ U | NU ] [ color-selection-criteria ] [ TOP ] |
Operands
search-string |
The search string that identifies the lines to be removed from exclude status. |
||
start-column |
|
||
end-column |
Right column of a range (with start-column) within which the search-string value must be found. |
||
FIRST |
Starts at the top of the data and searches ahead to find the first occurrence of search-string. |
||
LAST |
Starts at the bottom of the data and searches backward to find the last occurrence of search-string. |
||
NEXT |
Starts at the first position after the current cursor location and searches ahead to find the next occurrence of search-string. NEXT is the default. |
||
PREV |
Starts at the current cursor location and searches backward to find the previous occurrence of search-string. |
||
ALL |
Starts at the top of the data and searches ahead to find all occurrences of search-string. |
||
PREFIX |
Locates search-string at the beginning of a word. |
||
WORD |
Locates search-string when it is delimited on both sides by blanks or other non-alphanumeric characters. |
||
CHAR |
Locates search-string regardless of what precedes or follows it. |
||
SUFFIX |
Locates search-string at the end of a word. |
||
|
|
||
line-control-range |
The range of lines which are to be processed by the command. Line control ranges provide a powerful tool to customize the range of lines to be processed. The full syntax and allowable operands which make up a line control range are discussed in "Line Control Range Specification". Refer to that section of the documentation for details. |
||
U | NU |
Specifies a subset of the line range to be processed. U requests only User lines are to be processed, NU requests only non-User lines are to be processed. If neither U or NU are specified, all lines in the range will be processed. |
||
color-selection-criteria |
A request for selection based on the highlight color of the search-string. Color requests provide another powerful tool to control search selection. The full syntax and allowable operands which make up a color-selection-criteria are discussed in "Color Selection Criteria Specification". Refer to that section of the documentation for details. |
||
TOP |
|
Abbreviations and Aliases
PREFIX can also be spelled as PRE or PFX
SUFFIX can also be spelled as SUF or SFX
WORDS can also be spelled as WORD
CHARS can also be spelled as CHAR
Description
You can use the SHOW command to find a search string, and unexclude the lines that contains the string from the display. Note that the normal selection options of X and NX are not allowed, since SHOW operates only on excluded lines. You may also wish to review "Working with Excluded Lines" for more information.
To unexclude the next excluded line that contains the letters ELSE without specifying any other qualifications:
On the Command line, type:
SHOW ELSE
Press Enter. Since no other qualifications were specified, the letters ELSE can be:
- Uppercase or a mixture of uppercase and lowercase.
- At the beginning of a word (prefix), the end of a word (suffix), or the entire word (word)
- Anywhere within the current boundaries.
To unexclude the next line that contains the letters ELSE, but only if the letters are uppercase:
On the Command line, type:
SHOW C"ELSE"
and press Enter.
This type of selection is called a character string selection (note the C that precedes the search string) because it unexcludes the next line that contains the letters ELSE only if the letters are found in uppercase.
Created with the Personal Edition of HelpNDoc: Full-featured Help generator