Zweck
Sucht sequentiell nach einem Datensatz, der eine Bedingung erfüllt.
Klasse
Typ
Methode
Syntax
<oArrayServer>:Locate(
<uForBlock>,
[<uWhileBlock>],
[<uScope>]
) Æ lFound
Argumente
<uForBlock> | Bedingung, die der gesuchte Datensatz erfüllen muss. Wird die Bedingung als String angegeben, wird dieser automatisch in ein _Codeblock-Objekt umgewandelt. Die Umwandlung erfolgt hierbei über den Befehl |
&("{|Server| "+uForBlock+"}")
Als Vorgabe wird der Wert NIL verwendet.
Datentyp: | String | Codeblock | _Codeblock |
<uWhileBlock> | Bedingung, die jeder Datensatz erfüllen muss, damit <uForBlock> auf den Datensatz ausgeführt wird. Sobald ein Datensatz gefunden wird, der die Bedingung nicht erfüllt, wird die Operation beendet. Wird die Bedingung als String angegeben, wird dieser automatisch in ein _Codeblock-Objekt umgewandelt. Die Umwandlung erfolgt hierbei über den Befehl |
&("{|Server| "+uWhileBlock+"}")
Als Vorgabe wird der Wert NIL verwendet.
Datentyp: | String | Codeblock | _Codeblock |
<uScope> | Der Bereich der zu bearbeitenden Datensätze. Es werden folgende Werte unterstützt: |
Wert |
Beschreibung |
DBSCOPEALL |
Der Zielbereich umfaßt alle Datensätze. Dies ist die Voreinstellung. Wenn eine WHILE-Bedingung angegeben ist, wird DBSCOPEREST verwendet. |
DBSCOPEREST |
Der Zielbereich umfaßt die verbleibenden Datensätze ab der aktuellen Position. |
<nRecord> |
Der Zielbereich umfaßt die nächsten <nRecord> Datensätze. |
Datentyp: | Usual |
Rückgabewert
lFound | Logischer Wert der definiert, ob ein Datensatz gefunden wurde. |
TRUE | Ein Datensatz wurde gefunden. |
FALSE | Es wurde kein Datensatz gefunden. |
Datentyp: | Logic |
Beschreibung
bArrayServer:Locate() sucht sequentiell einen Datensatz im Datenserver, der einer bestimmten Bedingung entspricht. Wenn ein Datesatz gefunden wurde, steht der Datensatzzeiger auf diesem Datensatz. Andernfalls steht der Datensatzzeiger auf EoF.
Um in den Bedingungen <uForBlock> und <uWhileBlock> auf Felder, Zugriffe oder Methoden des Servers zugreifen zu können, muss diesen das Literal "Server" gefolgt von einem Doppelpunkt vorangestellt werden (siehe Beispiel).
Beispiel
Das folgende Beispiel sucht nach dem Feld LASTNAME.
oasServer:Locate({|Server| UPPER(Server:LASTNAME)=="BOND"})
Siehe auch
Page url: http://www.YOURSERVER.com/index.html?barrayserver_locate.htm