Parametry
| curs | číslo otevřeného kurzoru nebo číslo tabulky - viz podrobnosti |
| position | číslo záznamu (absolutní), z něhož se čte |
| 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 proměnné 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_len (čtení délky sloupce proměnné velikosti).
Hodnota funkce
Funkce vrací při úspěchu FALSE, při neúspěchu TRUE.
Viz