function Append(curs : tcurstab) : trecnum;
trecnum [cd_]Append([cdp_t cdp], tcurstab curs);
function [cd_]Append([cdp : cdp_t]; curs : tcurstab) : trecnum;
Parametry
curs | deklarovanß tabulka nebo otev°en² kurzor -viz podrobnosti |
[cdp | kontextovß prom∞nnß klienta] |
Popis
Funkce Append
p°idßvß nov² prßzdn² zßznam k tabulce nebo ke 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.
Ve funkci Append
nelze pou₧φt kurzory vzniklΘ spojenφm vφce tabulek.
V p°idanΘm zßznamu budou vÜechny sloupce mφt hodnoty NONE dle sv²ch typ∙ nebo implicitnφ hodnoty definovanΘ v nßvrhu tabulky. Jsou-li v tabulce definovßna integritnφ omezenφ, bu∩ musφ b²t spln∞na na implicitnφch hodnotßch, anebo jeÜt∞ ve stejnΘ transakci musφ b²t do sloupec; zapsßny vyhovujφcφ hodnoty.
Funkce Append
provedenß na tabulku je toto₧nß s funkcφ Insert
. P°i provedenφ na kurzor se vÜak liÜφ - Append
vlo₧φ zßznam na konec tabulky, do nφ₧ kurzor vede, Insert
vyu₧ije volnΘ mezery v tabulce po smazanΘm a uvoln∞nΘm zßznamu.
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
.
P°φklad
table
TAB1;
var
cislo : trecnum;
begin
cislo := Append(TAB1);
TAB1[cislo].jmΘno := "Josef";
...
Viz