Read_var

C/C++Pascal

BOOL [cd_]Read_var([cdp_t cdp], tcurstab curs, trecnum position, tattrib attr, uns16 index, uns32 start, uns32 size, void * buf, uns32 * psize);
function [cd_]Read_var([cdp : cdp_t]; curs : tcurstab; position : trecnum; attr : tattrib; index : uns16; start, size : uns32; var buffer; var psize : uns32) : Boolean;

Parametry

curs Φφslo otev°enΘho kurzoru nebo tabulky - viz podrobnosti
position Φφslo zßznamu
attr Φφslo sloupce, jeho₧ hodnota se Φte
index po°adφ v multiatributu
start odkud se Φte
size kolik bajt∙ se mß p°eΦφst
buffer prom∞nnß, do nφ₧ se ulo₧φ p°eΦtenß hodnota
psize v²stupnφ parametr: poΦet p°eΦten²ch bajt∙
[cdp kontextovß prom∞nnß klienta]

Popis

Funkce p°eΦte obsah sloupce prom∞nnΘ velikosti z databßze. Hodnotu zapφÜe do prom∞nnΘ buffer.

Objekt, z n∞ho₧ se mß Φφst, m∙₧e b²t bu∩ tabulka zadanß sv²m Φφslem (nalezen²m funkcφ Find_object) nebo otev°en² kurzor (funkcφ Open_cursor nebo Open_cursor_direct).

P°eΦteno bude nejv²Üe size bajt∙ od pozice start hodnoty sloupce prom∞nnΘ velikosti.

Je-li attr multiatribut, pak jedno volßnφ funkce Φte z jednΘ jeho hodnoty. Po°adφ v multiatributu urΦuje prom∞nnß index (Φφslovßno od 0). Nenφ-li sloupec multiatribut, pou₧ijte konstantu NOINDEX. PoΦet slo₧ek multiatributu zjistφ funkce Read_int_cnt.

Do prom∞nnΘ psize funkce zapφÜe poΦet skuteΦn∞ p°eΦten²ch bajt∙.

Funkce neprovßdφ ₧ßdnΘ zamykßnφ zßznam∙ v databßzi. M∙₧e Φφst i data prßv∞ p°episovanß jinou aplikacφ. Pokud prom∞nnß buffer nenφ dostateΦn∞ dlouhß, m∙₧e dojφt k p°epsßnφ pam∞ti a nßslednΘmu zhroucenφ systΘmu.

Funkci Read_var nahrazuje ve vnit°nφm programovacφm jazyce p°i°azovacφ p°φkaz mezi prom∞nnou a sloupcem prom∞nnΘ velikosti s dvojindexem [start, size].

Hodnota funkce

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

Viz