Zweck
Sucht in der aktiven Sortierung einen Datensatz mit dem angegebenen Schlüsselwert.
Klasse
Typ
Methode
Syntax
<oArrayServer>:Seek(
<uKeyValue>,
[<lSoftSeek>],
[<lLast>]
) Æ lFound
Argumente
<uKeyValue> | Schlüsselwert, nach dem gesucht werden soll. |
Datentyp: | Usual |
<lSoftSeek> | Logischer Wert der definiert, wie der Datensatzzeiger positioniert werden soll, wenn kein Datensatz mit dem angegebenen Feldwert gefunden wurde. TRUE positioniert den Datensatzzeiger auf den nächst größeren Datensatz, FALSE auf EoF. Wird das Argument nicht angegeben, wird die Einstellung aus SetSoftSeek() verwendet. |
Datentyp: | Logic |
<lLast> | Logischer Wert der definiert, ob das letzte Auftreten des Schlüsselwertes gesucht werden soll. Bei der Angabe TRUE wird der letzte Datensatz zum Schlüsselwert gesucht. Als Vorgabe wird FALSE verwendet. |
Datentyp: | Logic |
Rückgabewert
lFound | Logischer Wert der definiert, ob ein Datensatz zum angegebenen Schlüsselwert gefunden wurde. |
TRUE | Der Schlüsselwert wurde gefunden. |
FALSE | Der Schlüsselwert wurde nicht gefunden. |
Datentyp: | Logic |
Beschreibung
bArrayServer:Seek() sucht in der aktiven Sortierung einen Datensatz mit dem angegebenen Schlüsselwert. Die Suche beginnt beim ersten Datensatz.
Wird ein Datensatz gefunden, wird der Datensatzzeiger auf diesen positioniert und der Wert TRUE wird zurückgegeben. Andernfalls wird der Wert FALSE zurückgegeben, und der Datenserver wird wie folgt positioniert: Bei einer normalen Suche wird der Datenserver auf EoF positioniert. Bei einer SoftSeek-Suche wird der Datenserver auf den ersten Datensatz positioniert, dessen Schlüsselwert größer ist als der angegebene Schlüsselwert. Falls ein derartiger Datensatz nicht existiert, wird der Datenserver auf EoF positioniert.
Vor der Operation wird eine NotifyIntentToMove-Nachricht und anschließend eine NotifyRecordChange-Nachricht gesendet.
Siehe auch
Page url: http://www.YOURSERVER.com/index.html?barrayserver_seek.htm