Zum Hauptinhalt springen

c16_selread

Mit dieser Funktion wird eine Selektion in den Puffer geladen. Der Puffer muss zuvor mit dem Befehl c16_selopen() eingerichtet werden. Sofern die angegebene Selektion nicht vorhanden ist, wird die Selektion mit dem nächstgrößeren Namen geladen und _rNoKey zurückgeliefert.

Im Parameter (aSelection) wird das von c16_selopen() bereitgestellte Selektionsobjekt übergeben.

In (aFileNo) wird die Nummer der Datei angegeben, in der die Selektion definiert ist. Der Name der Selektion in (aName) kann entfallen, wenn _SelFirst, _SelLast, _SelPrev oder _SelNext in (aOptions) angegeben wird.

In (aOptions) können folgende Optionen angegeben werden:

  • _SelFirst: Die erste Selektion der Datei wird geladen.
  • _SelLast: Die letzte Selektion der Datei wird geladen.
  • _SelPrev: Die Selektion mit dem nächstkleineren Namen wird geladen. Sofern keine weitere Selektion in der Datei vorhanden ist, wird als Resultat _rNoRec zurückgeliefert.
  • _SelNext: Die Selektion mit dem nächstgrößeren Namen wird geladen. Sofern keine weitere Selektion in der Datei vorhanden ist, wird als Resultat _rNoRec zurückgeliefert.
  • _SelLock: Die gelesene Selektion wird exklusiv gesperrt. Dies ist nur dann der Fall, wenn _rOk zurückgeliefert wird (Selektion vorhanden). Ist die Selektion durch einen anderen Benutzer gesperrt, ist das Resultat _rLocked.
  • _SelSharedLock: Die gelesene Selektion wird nicht exklusiv gesperrt. Andere Benutzer können noch lesend auf die Selektion zugreifen und die Selektion mit der gleichen Option zusätzlich sperren. Mit dieser Sperr-Option kann die Selektion nur gelesen, nicht aber geändert werden. Soll die Selektion verändert werden, muss sie mit der Option _SelLock gesperrt werden.
  • _SelUnlock: Die gelesene Selektion wird entsperrt.
  • _SelKeyMode: Alternativer Verarbeitungsmodus

Die Angabe von _SelLock ist notwendig, wenn mit den Ergebnismengen der Selektion gearbeitet werden soll (c16_selclear(), c16_selrecinsert(), c16_selrecdelete(), c16_recread() und c16_reclink()).

Für das Lesen von Datensätzen werden die Funktionen c16_recread() bzw. c16_reclink() verwendet, wobei anstelle der Schlüssel- bzw. Verknüpfungsnummer das Selektionsobjekt angegeben wird.

Der Erfolg der Operation wird von der Funktion zurückgegeben. Bei der Überprüfung können folgende symbolische Konstanten verwendet werden:

  • 0: _rOK
  • 1: _rLocked
  • 3: _rNoKey
  • 4: _rLastRec
  • 5: _rNoRec

Tritt bei der Verarbeitung ein Fehler auf, wird der Fehlerwert von der Anweisung zurückgegeben. Der Fehler kann ebenfalls mit den Anweisungen c16_error() oder c16_errortext() ermittelt werden. Folgende Fehler können auftreten:

  • C16_OK (0): Kein Fehler aufgetreten.
  • C16ERR_ARGS_FORMAT (-251): Anzahl der Argumente oder Typ eines Arguments ungültig.
  • C16ERR_ARGS_SELECTION (-255): Kein Selektionsobjekt in aSelection übergeben.
  • C16ERR_NO_FILE (-601): Datei nicht vorhanden.