Close_cursor

c/c++pascal

BOOL [cd_]Close_cursor([cdp_t cdp], tcursnum curs);
function [cd_]Close_cursor([cdp : cdp_t]; curs : tcursnum) : Boolean;

Parametry

curs otevřený kurzor (pevný nebo proměnný)
[cdp kontextová proměnná klienta]

Popis

Funkce Close_cursor uzavře zadaný kurzor. Tento kurzor musí být otevřený. Uzavřením znemožní čtení a zápis dat prostřednictvím tohoto kurzoru. Funkce se hodí pro uzavírání kurzorů i subkurzorů..

Doporučuje se uzavírat kurzory, které program již nepotřebuje. Tím se uvolní část operační paměti. Počet otevřených kurzorů zjistíte pomocí funkce Owned_cursors.

Volání této funkce s parametrem -2 uzavře všechny kurzory, které patří volajícímu uživateli.

Pokud není kurzor explicitně uzavřen, uzavře jej 602SQL při ukončení běhu programu.

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.

Funkce zavolaná s parametrem -2 vrátí TRUE, pokud uživatel neměl otevřený žádný kurzor.

Viz