Write

c/c++pascal

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

Parametry

curs číslo otevřeného kurzoru nebo číslo tabulky - viz podrobnosti
position číslo záznamu (absolutní), kam se údaje mají zapsat
attr číslo sloupce, jehož hodnota (nebo délka) se přepisuje
access popis přístupu k údajům v uvedené pozici kurzoru
buffer proměnná obsahující údaje určené k zapsání do databáze
datasize velikost zapisovaných dat v bytech
[cdp kontextová proměnná klienta]

Popis

Funkce Write zapisuje údaje do databáze. Objekt, do něhož se má zapisovat, 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řed zápisem funkce ověří, zda přepisované záznamy jsou zamčeny, a pokud nejsou, pokusí se je dočasně zamknout na dobu zápisu. Pokud se zamčení nepovede, zápis se neprovede a dojde k chybě.

Obecná funkce Write s velmi složitým parametrem access je výhodné v jednotlivých konkrétních případech nahradit funkcemi Write_ind (zápis do sloupce pevné velikosti), Write_var (zápis do sloupce proměnné velikosti) a Write_len (zápis délky sloupce proměnné velikosti).

Hodnota funkce

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

Viz