Parametry
handle | handle (číslo) SQL požadavku získané funkcí SQL_prepare |
results | pole čísel, do nichž se zapíše informace o výsledku operace; pole musí mít svou první složku před zavoláním inicializovanou hodnotou nula |
count | počet SQL příkazů - výstupní parametr |
[cdp | kontextová proměnná klienta] |
Od verze:
5.1
Popis
Funkce provede dříve připravený příkaz, jehož handle dostane jako parametr.
Při volání funkce z vnějšího jazyka je nutné uvést výstupní parametr results. Tímto parametrem je pole 32-bitových celých čísel bez znaménka. Pole musí obsahovat nejméně tolik složek, kolik příkazů jazyka SQL je zadáno v parametru statement funkce SQL_prepare
. Parametr results slouží k získání informací o výsledku provádění příkazu. Má relevantní hodnotu pouze v případě, že funkce skončila úspěšně. Pokud byl proveden příkaz UPDATE, DELETE nebo INSERT, hodnotou příslušného prvku pole je počet zpracovaných záznamů. Pokud byl proveden dotazový výraz SELECT (není SQL příkaz, lze ho však zde použít pro otevření dotazu), pak ve spodních dvou bajtech prvku pole je číslo otevřeného kurzoru a s otevřeným kurzorem je možné dále pracovat (stejně jako by byl otevřen pomocí funkce Open_cursor_direct
). Otevřený kurzor se zavírá pomocí funkce Close_cursor
.
Počet provedených SQL příkazů je zapsán do výstupní proměnné count.
Hodnota funkce
Funkce vrací TRUE při chybě.
Viz