Zum Hauptinhalt springen

c16_selrecdelete

c16_selrecdelete(aSelection : resource, aFileNo : int) : int​

Datensatz aus der Selektion entfernen

Details

Diese Funktion entfernt den aktuell im Hauptspeicher befindlichen Datensatz der Datei (aFileNo) aus einer Ergebnismenge der Selektion im Puffer. Dabei ist zu beachten, dass der Sortierungswert des Satzes in der Ergebnismenge mit dem tatsächlichen Sortierungswert im Datensatz übereinstimmen muss, da sonst der Datensatz nicht gelöscht werden kann (beispielweise ist die Selektionsmenge nach Namen sortiert, der Name im Datensatz hat sich mittlerweile aber verändert). c16_selrecdelete() kann sowohl bei der Hauptergebnismenge als auch bei verknüpften Ergebnismengen benutzt werden. Für die Hauptergebnismenge kann auch 0 in (aFileNo) übergeben werden.

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

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

  • 0: _rOK Datensatzoperation erfolgreich.
  • 3: _rNoKey In der Selektion ist kein Satz mit dem gewünschten Schlüsselwert vorhanden.
  • 5: _rNoRec In der Selektion ist keine Datensatz vorhanden.
  • 6: _rNoLock Die Selektion ist nicht gesperrt.

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.