SQL_CDecl
- lk
Owned by lk
Erzeugt einen Cursor auf der Datenbank, um mehrere Datensätze lesen zu können.
Prototype
SQL_CDecl( id, query )
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 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.