Erzeugt einen Cursor auf der Datenbank, um mehrere Datensätze lesen zu können.
Prototype
Parameter
Parameter | Typ | Bedeutung |
---|
id | string | Eindeutiger Bezeichner für den Cursor |
query | string | Select-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 und verwendet und ist alleine wirkungslos.
- Jeder mit SQL_CDecl angelegte Cursor muss mit 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 verwendet werden.
Beispiel
Beispiel ist zu finden in .