Die Methode FindNearest bewegt den Cursor zum ersten Datensatz, der die größte Übereinstimmung mit den angegebenen Schlüsselwerten aufweist.

Delphi Syntax:

procedure FindNearest(const KeyValues: array of const);

C++ Syntax:

void __fastcall FindNearest(const System::TVarRec* KeyValues, const int KeyValues_Size);

Beschreibung

Mit FindNearest kann der Cursor zu einem bestimmten Datensatz in einer Datenmenge oder zum ersten Datensatz der Datenmenge bewegt werden, der größer als die im Parameter KeyValues angegebenen Werte ist. KeyValues enthält ein Komma-Getrenntes-Array mit Feldwerten, das als Schlüssel bezeichnet wird. Bei den Werten des Schlüssels kann es sich um Literale, Variablen, Null, oder nil handeln. Wenn die in KeyValues übergebene Anzahl der Werte kleiner als die Anzahl der Spalten des für die Suche verwendeten Index ist, wird für die fehlenden Werte Null verwendet.

Der Schlüssel muss immer ein Index sein, der in der Eigenschaft IndexName angegeben werden kann. Wenn für IndexName kein Wert angegeben wurde, verwendet FindKey den Id-Index der Tabelle.

FindNearest positioniert den Cursor entweder auf einem Datensatz, der genau mit den Suchkriterien übereinstimmt oder auf dem ersten Datensatz, dessen Werte größer als die in den Suchkriterien angegebenen Werte sind.