Insert_record_ex

C/C++Pascal

BOOL [cd_]Insert_record_ex([cdp_t cdp,] tcurstab curs, trecnum * position, unsigned colcount, const t_column_val_descr * colvaldescr);
function [cd_]Insert_record_ex([cdp : cdp_t;] curs : tcurstab; var position : trecnum; colcount : integer; colvaldescr : pt_column_val_descr) : Boolean;


Parametry

cdp
kontextovß prom∞nnß klienta
curs
Φφslo tabulky nebo otev°enΘho kurzoru
position
Φφslo vlo₧enΘho zßznamu
colcount
poΦet zapisovan²ch sloupc∙ uveden²ch v colvaldescr
colvaldescr
popis hodnot sloupc∙


Od verze

7.0c

Popis

Funkce vlo₧φ zßznam do tabulky nebo kurzoru stejn²m zp∙sobem jako SQL p°φkaz INSERT. Hodnoty se zapφÜou do sloupc∙ uveden²ch v poli colvaldescr, ostatnφ sloupce budou mφt ve vlo₧enΘm zßznamu svΘ implicitnφ hodnoty. ╚φslo vlo₧enΘho zßznamu se vrßtφ v position.

Funkce nahrazuje zastaralou funkci Write_record volanou po Insert.

Funkce neumo₧≥uje zapisovat hodnoty multiatribut∙.

Provedenφ funkce m∙₧e vyvolat akce aktivnφ referenΦnφ integrity a triggery.

Popis sloupc∙ v colvaldescr:

Pole colvaldescr obsahuje colcount zßznam∙ tohoto typu:

struct t_column_val_descr
{ int          column_number;  // po°adovΘ Φφslo sloupce v tabulce nebo kurzoru
  const void * column_value;  // ukazatel na hodnotu, kterß se mß zapsat do sloupce
  int          value_length;  // dΘlka hodnoty v column_value
};

Pokud ukazatel column_value je NULL, pak se do sloupce zapφÜe hodnota NULL. ┌daj value_length se pou₧ije pouze pro sloupce prom∞nnΘ velikosti, pro ostatnφ sloupce se ignoruje.



Nßvratovß hodnota

Funkce vracφ FALSE p°i ·sp∞chu, TRUE p°i chyb∞.

Viz