Read

C/C++Pascal

BOOL [cd_]Read([cdp_t cdp], tcurstab curs, trecnum position, tattrib attr, const modifrec * access, void * buffer);
function [cd_]Read([cdp : cdp_t]; curs : tcurstab; position : trecnum; attr : tattrib; var access; var buffer) : Boolean;

Parametry

curs Φφslo otev°enΘho kurzoru nebo Φφslo tabulky - viz podrobnosti
position Φφslo zßznamu
attr Φφslo sloupce, jeho₧ hodnota (nebo dΘlka) se Φte
access popis p°φstupu k ·daj∙m v uvedenΘ pozici kurzoru
buffer prom∞nnß, do nφ₧ majφ b²t ·daje naΦteny
[cdp kontextovß prom∞nnß klienta]

Popis

Funkce Read Φte hodnoty z databßze. 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).

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.

Pokud se Φte hodnota sloupce prom∞nnΘ velikosti, pak funkce zapφÜe do pole buffer do prvnφch dvou bajt∙ dΘlku p°eΦtenΘho ·seku a poΦφnaje t°etφm bajtem p°eΦtenß data.

Obecnou funkci Read s velmi slo₧it²m parametrem access je v²hodnΘ v jednotliv²ch konkrΘtnφch p°φpadech nahradit funkcemi Read_ind (Φtenφ sloupce pevnΘ velikosti), Read_var (Φtenφ sloupce prom∞nnΘ velikosti), Read_ind_cnt (Φtenφ poΦtu slo₧ek multiatributu), Read_len (Φtenφ dΘlky sloupce prom∞nnΘ velikosti).

Funkci Read nahrazuje ve vnit°nφm programovacφm jazyce p°i°azovacφ p°φkaz mezi prom∞nnou a databßzov²m sloupcem.

Hodnota funkce

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

Viz