Navigation:  Klassen > bArrayServer >

bArrayServer:Locate()

Diese Seite drucken    Vorherige SeiteZurück zum Anfang des KapitelsNächste Seite

Zweck

Sucht sequentiell nach einem Datensatz, der eine Bedingung erfüllt.

Klasse

bArrayServer

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

lFoundLogischer Wert der definiert, ob ein Datensatz gefunden wurde.
TRUEEin Datensatz wurde gefunden.
FALSEEs 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

bArrayServer:Seek()

 


Page url: http://www.YOURSERVER.com/index.html?barrayserver_locate.htm