Zum Hauptinhalt springen

c16_recdelete

c16_recdelete(aConnection : resource, aFileNo : int, aOptions : int) : int​

Datensatz löschen

Details

Mit dieser Funktion kann ein Datensatz in der Datei (aFileNo) gelöscht werden. Dabei wird immer über den ersten Schlüssel zugegriffen. Der Satz wird nur bei dem Ergebnis _rOk gelöscht. Im Parameter (aConnection) wird das von c16_connect() bereitgestellte Verbindungsobjekt übergeben. Der Parameter (aOptions) bestimmt, welcher Datensatz gelöscht wird.

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

  • 0: _rOk Datensatzoperation erfolgreich.
  • 1: _rLocked Der Datensatz konnte nicht gelöscht werden, da er von einem anderen Benutzer gesperrt ist.
  • 3: _rNoKey In der Datei ist kein Satz mit dem gewünschten Schlüsselwert vorhanden. Es wurde der Satz mit dem nächst größeren Schlüsselwert geladen.
  • 4: _rLastRec In der Datei ist weder ein Satz mit dem gewünschten Schlüsselwert noch ein Satz mit einem größeren Schlüsselwert vorhanden. Es wurde der Satz mit dem größten Schlüsselwert geladen.
  • 5: _rNoRec Es wurde kein Satz geladen, da entweder die Datei leer ist, oder kein vorhergehender bzw. nachfolgender Satz existiert.
  • 10: _rDeadlock Der Datensatz konnte aufgrund einer Verklemmung nicht gelöscht werden.

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_CONNECTION (-254): Kein Verbindungsobjekt in aConnection übergeben.
  • C16ERR_NO_FILE (-601): Datei nicht vorhanden.