SearchNum()

Syntax:

SearchNum(Relation R, Real rank [, String sortindex]) : Tupel
R: Relation, die durchsucht werden soll
rank:
sortindex: optional der zu benutzende Sortierindex (nicht für dBase)

Beispiel:

t := SearchNum(stamm, 112)

Beschreibung:

Diese Funktion ist veraltet und sollte nicht benutzt werden. Stattdessen bitte SearchAll() benutzen.

Sucht das Tupel, das im Schlüsselindex die Reihenfolgenummer rank hat. So kann man die Relation sortiert durcharbeiten. Im Allgemeinen ist die Benutzung dieser Funktion zu vermeiden, da sie darauf hinweist, dass der Algorithmus einer unsauberen Analyse entsprungen ist (Array-Denken). Sehr hilfreich ist sie jedoch, falls der Schlüssel nicht eindeutig ist. Ist rank < 0 oder rank >= Anzahl Tupel, so wird ein ungültiges Tupel (siehe IsValid()) zurückgegeben.

Statt nach dem Schlüsselindex kann auch nach einem beliebigen Sortierindex gesucht werden. Der Feldname (oder die Feldnamen) wird dazu als Parameter sortindex übergeben.

Wenn R eine Memory-Relation ist (siehe NewMemRelation()), so liefert SearchNum unmittelbar das Tupel aus R (also keine Kopie). Änderungen auf diesem Tupel wirken sich also direkt auch auf R aus.

Siehe auch SearchFirst() und SearchAll().