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