Read_record

c/c++pascal

BOOL [cd_]Read_record([cdp_t cdp], tcurstab curs, trecnum position, void * buf, uns16 datasize)
function [cd_]Read_record([cdp : cdp_t]; curs : tcurstab; position : trecnum; var buffer; datasize : uns16) : Boolean;

Parametry

curs číslo tabulky nebo číslo otevřeného kurzoru - viz podrobnosti
position číslo záznamu
buffer buffer pro data
datasize velikost dat v bajtech
[cdp kontextová proměnná klienta]

Popis

Funkce přečte celý záznam z tabulky zadané svým číslem (nalezeným funkcí Find_object) nebo kurzoru (otevřeného funkcí Open_cursor nebo Open_cursor_direct).

Funkce přečte ze záznamu s číslem position v tabulce nebo kurzoru curs všechny sloupce. Hodnoty těchto sloupců zapíše do proměnné buffer bezprostředně za sebou. Jejich celková velikost musí být datasize.

Hodnoty sloupců jsou načteny do buffer v tom pořadí, v němž jsou definovány v tabulce nebo kurzoru curs. Funkce nepracuje se sloupcem DELETED, s hodnotami multiatributů ani sloupců proměnné velikosti. Pro ně se v buffer nevynechává žádné místo.

V parametru buffer musí být pro každý čtený sloupec typu řetězec o jeden bajt více, než činí maximální délka řetězce.

Hodnota funkce

Funkce vrací při úspěchu FALSE, při neúspěchu TRUE.

Viz