Parametry
| cdp | kontextovß prom∞nnß klienta] |
| statement | p°φkaz jazyka SQL |
| results | pole Φφsel, do nich₧ se zapφÜe informace o v²sledku operace |
| hostvars | pole popisujφcφ prom∞nnΘ klienta |
| hostvars_count | poΦet slo₧ek pole hostvars |
Popis
Funkce vykonß p°φkaz jazyka SQL zadan² v parametru statement. Platφ pro nφ vÜe, co je uvedeno v popisu funkce SQL_execute,.
Pomocφ pole hostvars lze SQL serveru p°edat popis prom∞nn²ch klientskΘ aplikace, kterΘ mohou b²t pou₧ity v p°φkazu statement. Parametr hostvars_count obsahuje poΦet takto p°edßvan²ch prom∞nn²ch.
Pro ka₧dou p°edßvanou prom∞nnou je nutno vyplnit jednu slo₧ku pole hostvars typu t_clivar takto:
| Polo₧ka | Obsah a v²znam |
| name | jmΘno prom∞nnΘ velk²mi pφsmeny, °et∞zec ukonΦen² znakem s k≤dem 0 |
| mode | sm∞r p°edßvßnφ hodnoty prom∞nnΘ, konstanta MODE_IN, MODE_OUT nebo MODE_INOUT |
| wbtype | typ prom∞nnΘ, jedna z konstant oznaΦujφcφ databßzovΘ typy, ATT_... |
| buf | ukazatel na prom∞nnou |
| buflen | velikost prom∞nnΘ v bajtech resp. velikost prostoru pro hodnotu |
| actlen | skuteΦnß velikost hodnoty v bajtech (pou₧φvß se pouze pro type prom∞nnΘ velikosti) |
Pro vstupnφ hodnoty prom∞nnΘ velikosti (BLOB, CLOB) je t°eba vyplnit nejen dΘlku bufferu pro hodnotu buflen, ale i skuteΦnou dΘlku hodnoty actlen. Pro v²stupnφ hodnoty prom∞nnΘ velikosti (BLOB, CLOB) staΦφ vyplnit dΘlku bufferu pro hodnotu buflen, zatφmco skuteΦnß dΘlka hodnoty actlen se ve struktu°e objevφ po provedenφ p°φkazu.
Hodnota funkce
Funkce vracφ hodnotu FALSE, pokud se akci poda°ilo ·sp∞Ün∞ provΘst. V opaΦnΘm p°φpad∞ vracφ TRUE a povahu chyby lze zjistit volßnφm funkce Signalize.
P°φklad
Viz Prom∞nnΘ z externφch jazyk∙ v p°φkazech SQL
Viz