Locate

This is an old revision of Locate, edited by BigChimp at . The current revision is 86078.

Added example, layout, tip to use sql

Template:Translate

Definition

Unit: FreePascal, unit db

    function  Locate(const KeyFields: string; const KeyValues: Variant; Options: TLocateOptions): Boolean; override;

Official documentation: none

Description

locate looks for a record in the dataset where the specified search values for the specified fields match. If found, the function returns true and the cursor position/current record moves to that record.

KeyFields can be a single field name or a semicolon-separated list of fields.

KeyValue can be a variant or a variant array and the number of items must match the number of fields specified in KeyFields.

Search options can be

Locate is only implemented in non-unidirectional datasets, i.e. you must be able to move back and forwards through the dataset.

Locate and lookup act at low level inside a dataset to search for records. Often it is more efficient to filter/limit what gets into the dataset in the first place, e.g. using SQL WHERE clauses.

Example

// Using a TDBF dataset
uses dbf, db
...
// Look for 'di Angelo', 'Di Angelo' etc in a field called
// LASTNAME
if MyDBF.Locate('LASTNAME','di Angelo',[loCaseInsensitive])then
  writeln('Found record.');

See also