Parametry
| curs | číslo tabulky nebo otevřeného kurzoru |
| [cdp | kontextová proměnná klienta] |
Popis
Funkce Append přidává nový prázdný záznam k tabulce nebo k editovatelnému kurzoru curs za všechny existující záznamy. První provedení Append na určitou tabulku resp. kurzor může chvíli trvat, protože se musí projít všechny záznamy patřící do tabulky resp. kurzoru.
Vzhledem k tomu, že pořadí záznamů v tabulkách se nikde prakticky nevyužívá, není žádný důvod proč nepoužít rychlejší funkci Insert.
Pro funkci Append platí poznámky o transakcích, triggerech a editaci obecně uvedené u funkce Insert.
Efektivnějším způsobem práce s daty (vkládání, mazání, vyhledávání) je použití jazyka SQL, zvláště pak uložených procedur.
Hodnota funkce
Funkce vrací absolutní číslo přidaného záznamu. Toto číslo lze po provedení Append použít pro zápis do přidaného záznamu v tabulce resp. kurzoru curs, kam byl nový záznam přidán. Vrácená hodnota je o 1 menší než hodnota, kterou by vrátila funkce Rec_cnt zavolaná po Append.
Pokud se operace neprovede, vrací se hodnota -1. Povahu chyby lze pak zjistit voláním funkce Signalize.
Viz