Search list

Command groupFlag affectedReversibleExecute on clientPlatform(s)
ListsYESNONOAll

Syntax

Search list
 
 ([
From start
][,
Only test selected lines
][,
Select matches OR
][,
Deselect non-matches AND
][,
Do not load line
])

Options

From startIf specified,the command starts with the first line of the list,rather than the line immediately after the current line
Only test selected linesIf specified,the command only operates on selected lines
Select matches ORIf 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 ANDIf specified,the command processes all specified lines,and deselects lines which do not match the search
Do not load lineIf 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

Description

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.

Example

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
)