Zum Hauptinhalt springen

c16_recreplace

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

Datensatz ersetzen

Details

Im Parameter (aConnection) wird das von c16_connect() bereitgestellte Verbindungsobjekt übergeben. Diese Funktion speichert einen Datensatz in die angegebene Datei (aFileNo) zurück, der zuvor geladen und gesperrt wurde. Ein nicht gesperrter Satz kann nicht zurückgespeichert werden. Alle Felder des gelesenen Satzes können vor dem Rückspeichern verändert werden (inkl. aller Schlüsselfelder). Dabei ist zu beachten, dass eindeutige Schlüsselwerte nicht bereits in der Datei enthalten sein dürfen. Durch (aOptions) kann angegeben werden, ob der Datensatz nach dem Rückspeichern weiter gesperrt bleiben soll oder nicht. Wird keine der beiden Optionen benutzt, wird der Satz entsperrt.

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.
  • 6: _rExists Der Datensatz konnte nicht zurückgespeichert werden, da ein Satz mit einem identischen eindeutigen Schlüsselwert bereits existiert.
  • 7: _rNoLock Der Datensatz konnte nicht zurückgespeichert werden, da er nicht gesperrt ist.
  • 10: _rDeadlock Der Datensatz konnte aufgrund einer Verklemmung nicht ersetzt 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): Die übergebene Dateinummer existiert nicht.