SearchFromTop command: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Created page with "__TOC__ {| |width="50%"| '''Action:''' |width="50%"| Searches down, from the top of the current main window page, for the search string yo...")
 
No edit summary
Line 4: Line 4:
|width="50%"| '''Action:'''
|width="50%"| '''Action:'''
|width="50%"|
|width="50%"|
[[search_facility.html#search_top|Searches]] down, from the top of the current main window page, for the search string you specify in the command. Repeating the command only locates the same occurrence of the search string. The search is ''not'' case sensitive.  
[[Search facility#The Search button|Searches]] down, from the top of the current main window page, for the search string you specify in the command. Repeating the command only locates the same occurrence of the search string. The search is ''not'' case sensitive.  


Optionally, searches from the top ''of the Client window you specify'' as the value of the command's In ''window'' prefix.  
Optionally, searches from the top ''of the Client window you specify'' as the value of the command's In ''window'' prefix.  
Line 13: Line 13:
<span class="f_Para">where:</span>
<span class="f_Para">where:</span>
*''window'' is one of the following keywords, not case sensitive, which identify a Client window. Links are provided to help identify the less common windows:  
*''window'' is one of the following keywords, not case sensitive, which identify a Client window. Links are provided to help identify the less common windows:  
:: <span class="f_CodeExList">[[help_menu_opts.html#about_opt|about]] </span><br />
:: <span class="f_CodeExList">[[Help menu options|about]] </span><br />
:: <span class="f_CodeExList">auditTrail</span><br />
:: <span class="f_CodeExList">auditTrail</span><br />
:: <span class="f_CodeExList">[[help_menu_opts.html#commands_opt|commands]] </span><br />
:: <span class="f_CodeExList">[[Help menu options|commands]] </span><br />
:: <span class="f_CodeExList">console </span><br />
:: <span class="f_CodeExList">console </span><br />
:: <span class="f_CodeExList">[[display_stmt_history.html|executionHistory]] </span><br />
:: <span class="f_CodeExList">[[Displaying a statement history|executionHistory]] </span><br />
:: <span class="f_CodeExList">executionTrace </span><br />
:: <span class="f_CodeExList">executionTrace </span><br />
:: <span class="f_CodeExList">[[help_menu_opts.html#keyboard_scuts|keyboardShortcuts]]</span><br />
:: <span class="f_CodeExList">[[Help menu options|keyboardShortcuts]]</span><br />
:: <span class="f_CodeExList">source  </span><br />
:: <span class="f_CodeExList">source  </span><br />
:: <span class="f_CodeExList">[[copying_printing_saving_text.html|textviewer]]  </span><br />
:: <span class="f_CodeExList">[[Copying, printing, or saving text|textviewer]]  </span><br />
:: <span class="f_CodeExList">[[displaying_variable_values.html|value]] </span><br />
:: <span class="f_CodeExList">[[Displaying temporarily the value of a program data item|value]] </span><br />
:: <span class="f_CodeExList">watchWindow </span><br />
:: <span class="f_CodeExList">watchWindow </span><br />
:: <span class="f_CodeExList">webBuffer </span>
:: <span class="f_CodeExList">webBuffer </span>

Revision as of 03:41, 8 December 2022

Action:

Searches down, from the top of the current main window page, for the search string you specify in the command. Repeating the command only locates the same occurrence of the search string. The search is not case sensitive.

Optionally, searches from the top of the Client window you specify as the value of the command's In window prefix.

Syntax:

[in window] searchFromTop search_string

where:

  • window is one of the following keywords, not case sensitive, which identify a Client window. Links are provided to help identify the less common windows:
about 
auditTrail
commands 
console 
executionHistory 
executionTrace 
keyboardShortcuts
source  
textviewer  
value 
watchWindow 
webBuffer 
  • search_string is the required search string, with no additional quotation marks.
  • To locate a target string that begins with an ampersand (&) and is not the name of a macro variable or Client function, prefix the target with a backslash (\) to treat the ampersand as a literal.

To locate a single backslash character, escape the target backslash with a second backslash (searchFromTop \\).  

Command examples:

in WatchWindow searchFromTop printText 

searchFromTop &a  

(searches for value of macro variable &a)

in auditTrail searchFromTop \&&myProc

(searches for string &&myProc)

Related commands include: searchUp, searchDown, searchFromBottom

Client menu: Search > Search From Top
Introduced: --