Funkce modifikuje obsah zßznamu v tabulce nebo kurzoru stejn²m zp∙sobem jako SQL p°φkaz UPDATE. Hodnoty se zapφÜou pouze do sloupc∙ uveden²ch v poli colvaldescr, ostatnφ z∙stanou nezm∞n∞ny.
Funkce nahrazuje zastaralou funkci Write_record.
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.
Funkce vracφ FALSE p°i ·sp∞chu, TRUE p°i chyb∞.