| Command group | Flag affected | Reversible | Execute on client | Platform(s) |
|---|---|---|---|---|
| Lists | YES | NO | NO | All |
Search list ([From start][,Only test selected lines][,Select matches (OR)][,Deselect non-matches (AND)][,Do not load line])
| From start | If specified, the command starts with the first line of the list rather than the line immediately after the current line |
| Only test selected lines | If specified, the command only operates on selected lines |
| Select matches (OR) | If specified, the command processes all specified lines and selects lines which match the search; any lines selected before the command executes remain selected |
| Deselect non-matches (AND) | If specified, the command processes all specified lines and deselects lines which do not match the search |
| Do not load line | If specified, the line found by the search is not loaded into the current record buffer; this is only relevant when 'Select matches (OR)' and 'Deselect non-matches (AND)' are both not specified |
This command has been deprecated and is no longer visible in the Code Assistant in the Code Editor (it will not appear when you type the first few characters), although it is still present in Omnis Studio and will continue to function if used in legacy code. You can show this command by disabling the appropriate Command Filter in the Modify menu in the Code Editor.
This command searches the current list for field values that match the current search class or search calculation and loads them into the Current Record Buffer. The search starts at the beginning of the list if From start is checked, otherwise at the line after the current line.
If Omnis finds a line that matches the search class, that line number becomes the current line $line and the flag is set. If Omnis cannot find a matching line, the $line is cleared and the flag is cleared. If there is no current search class, all lines are said to match and Omnis sets the flag.
When checked, the Do Not Load Line option ensures the line found by the search is not loaded into the current record buffer.
The Only test selected lines option restricts the list scan to selected lines only. If the Select matches (OR) option is checked, the command scans all the lines from the line after the current line to the end and selects all those that match the search; if you also use the From start option, the whole of the list is scanned, that is, the search starts at line 1. Lines that are already selected before the command is executed remain selected. This is equivalent to ORing the existing selected lines with the lines that match the search. The current line is not affected.
If the Deselect non-matches (AND) option is used, the command scans all the lines from the line after the current line to the end and deselects all those which do not match the search; if you also use the From start option, the whole of the list is scanned, that is, the search starts at line 1. Lines which are already selected before the command is executed are deselected if they do not match the search, that is, the only lines left selected are those which were already selected and which match the search. This is equivalent to ANDing the existing selected lines with the lines which match the search. The current line is not affected.
Using the Select and the Deselect options together alters the selection state so that matching lines are selected, non-matching lines are deselected. The current line is not affected.
Set current list iList1
Define list {iColNum}
Calculate iColNum as 1
Repeat
Add line to list
Calculate iColNum as iColNum+1
Until iColNum=6
Set search as calculation {iColNum=3|iColNum=4}
Search list (From start) ## current line is now 3
Search list (Select matches (OR)) ## selects line 4
# or do it like this
Do iList1.$search(iColNum=3|iColNum=4,kTrue,kFalse,kTrue,kFalse)
Do iList1.$first(kTrue)