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 starší funkci Write_record volanou po funkci Insert.

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