Takes 4 parameters, FieldBase, Left, Comparison, Right
FieldBase, Left, Comparison, Right
[WorkWith], Left, Comparison, Right
FieldBase, Left, [""], [""]
[WorkWith], Left, [""], [""]
All Records in the Query that evaluate to True based on the Comparison Operator will be kept, all others will be discared. Note that the Comparison is a parameter, and as such, may be passed from the Top Query or be a quoated text string literal.
Alternatively, if both Comparison and Right are blank, then all Records in the Query where the Field referenced in Left is not blank (True) will be kept. This logic may be inversed by using Not followed by a space in front of the Field name. Note that this form is faster / more efficient than using a Comparison.
In the first example below we load the database table "MemTab.Person" into our work query. We then keep a record in the work query if the field "MemTab.Person.Firstname" is equal to the string literal "Bob".
In the second example we keep records that don't have a value in the work query field "MemTab.Person.Firstname"
KeepIf "MemTab.Person.", "Firstname", "=", "`Bob"
KeepIf "Not MemTab.Person.Firstname"