Zum Hauptinhalt springen

c16_selclear

c16_selclear(aSelection : resource) : int​

Inhalt des Selektionspuffers löschen

Details

Mit dieser Funktion wird der Inhalt des Selektionspuffers komplett gelöscht. Eine Selektion muss vorher mit c16_selread() sperrend gelesen worden sein. Nach c16_selclear() verfügt die Selektion über eine leere Ergebnismenge. Dadurch kann beispielsweise die Ergebnismenge mit c16_selrecinsert() gefüllt werden.

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

Der Rückgabewert vom Typ int beinhaltet entweder 0 (kein Fehler) oder einen negativen Fehlerwert (siehe Fehlerwerte ).

  • 0: _rOK Datensatzoperation erfolgreich.
  • 7: _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.