c16_recinsert

c16_recinsert(aConnection : resource, aFileNo : int, aOptions : int) : int

Datensatz einfügen

Details

• aConnection: Verbindungsobjekt
• aFileNo: Dateinummer
• aOptions:
  • Optionen:
  • _RecLock
  • _RecSingleLock
  • _RecSharedLock
• Resultat: int Fehlerwert
• Siehe: Befehle der PHP-Schnittstelle , c16_recdelete() , c16_recreplace()

Im Parameter (aConnection) wird das von c16_connect() bereitgestellte Verbindungsobjekt übergeben. Mit dieser Funktion wird der momentan im Speicher stehende Datensatz (bestehend aus den aktuellen Feldinhalten) als neuer Satz in die angegebene Datei (aFileNo) eingefügt. Wird als Parameter (aOptions) die symbolische Konstante _RecLock übergeben, ist der Datensatz nach dem Einfügen gesperrt.

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 eingefügt oder zurückgespeichert werden, da ein Satz mit einem identischen eindeutigen Schlüsselwert bereits existiert.
• 10: _rDeadlock Der Datensatz konnte aufgrund einer Verklemmung nicht eingefügt 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.