Skip to main content
Version: Next

QUERY WITH ARRAY

QUERY WITH ARRAY ( targetField ; array )

ParameterTypeDescription
targetFieldFieldField used to compare the values
arrayArrayArray of the searched values

Description

The QUERY WITH ARRAY command searches all the records for which the value of targetField is equal, at least, to one of the values of the elements in array. The records found will become the new current selection.

This command allows you to quickly and simply build a search on multiple values.

Notes:

  • This command cannot be used with fields of the Picture or BLOB type.
  • targetField and array must be of the same data type. Exception: you can use a Longint array with a field of the Time type.

Example

The following example allows you to retrieve the records of both French and American clients:

 ARRAY TEXT(searchArray;2)
 SearchArray{1}:="FR"
 SearchArray{2}:="US"
 QUERY WITH ARRAY([Clients]Country;SearchArray)

See also

QUERY SELECTION WITH ARRAY

Properties

Command number644
Thread safe
Changes current selection