SQL_CDecl

Erzeugt einen Cursor auf der Datenbank, um mehrere Datensätze lesen zu können.

Prototype


SQL_CDecl( id, query )

Parameter


ParameterTypBedeutung
idstringEindeutiger Bezeichner für den Cursor
querystringSelect-Statement

Hinweise


  • Der Mandant muss eingeschränkt werden, dies erfolgt nicht wie zum Teil bei andern Lua-Funktionen automatisch!
  • Im Fehlerfall (z.B. ungültiges SQL-Statement) wird sofort ein Laufzeitfehler ausgelöst, daher hat die Funktion auch keinen Rückgabewert. Wenn kein Laufzeitfehler aufgetreten ist, dann ist also davon auszugehen, dass alles in Ordnung ist.
  • Die Funktion wird nur im Zusammenhang mit SQL_CFetch und SQL_CFree verwendet und ist alleine wirkungslos.
  • Jeder mit SQL_CDecl angelegte Cursor muss mit SQL_CFree freigegeben werden!
  • Das SQL-Statement kann, muss aber nicht mit einem Semikolon beendet werden.
  • Gibt man ein ungültiges SQL-Statement an, führt dies zu einem Laufzeitfehler.
  • zum Lesen mehrerer Datensätze kann auch die Lua-Funktion SQL_Fetch verwendet werden.

Beispiel

Beispiel ist zu finden in SQL_CFetch.