Popis funkcí exportovaných z knihovny nddbe.dll

Podobné dokumenty
Knihovna DataBoxLib TXV první vydání prosinec 2010 změny vyhrazeny

STŘEDNÍ PRŮMYSLOVÁ ŠKOLA ELEKTROTECHNIKY A INFORMATIKY, OSTRAVA, PŘÍSPĚVKOVÁ ORGANIZACE DORG ORGANIZÉR. Dlouhodobá praktická maturitní práce

Programování v C++, 2. cvičení

Knihovna XmlLib TXV druhé vydání říjen 2012 změny vyhrazeny

Sada 1 - PHP. 03. Proměnné, konstanty

Semestrální práce 2 znakový strom

programátorský manuál

Práce s binárními soubory. Základy programování 2 Tomáš Kühr

Popis rozšířujících funkcí JScriptu

Algoritmizace a programování

Knihovna EpsnetLib TXV první vydání září 2012 změny vyhrazeny

Knihovna XmlLib TXV první vydání prosinec 2010 změny vyhrazeny

Konstruktory a destruktory

Práce se soubory. Úvod do programování 2 Tomáš Kühr

Knihovna WebGraphLib

Popis funkcí a parametrů programu. Reliance External communicator. Verze 1.5.0

Základy C++ I. Jan Hnilica Počítačové modelování 18

Soubory. Hung Hoang Dieu. Department of Mathematics Faculty of Nuclear Sciences and Physical Engineering Czech Technical University in Prague 1 / 7

PROMĚNNÉ, KONSTANTY A DATOVÉ TYPY TEORIE DATUM VYTVOŘENÍ: KLÍČOVÁ AKTIVITA: 02 PROGRAMOVÁNÍ 2. ROČNÍK (PRG2) HODINOVÁ DOTACE: 1

Algoritmizace prostorových úloh

Práce se soubory. Úvod do programování 2 Tomáš Kühr

DATABÁZE MS ACCESS 2010

PB161 Programování v C++ Proudy pro standardní zařízení Souborové proudy Paměťové proudy Manipulátory

Druhy souborů. textové. binární. nestrukturované txt strukturované - ini, xml, csv. veřejné bmp, jpg, wav proprietární docx, cdr, psd

Řada programovacích jazyků nabízí prostředky pro řešení meziprocesové komunikace jako je synchronizace a řízení přístupu do kritické sekce.

- dělají se také pomocí #define - podobné (použitím) funkcím - předpřipravená jsou např. v ctype.h. - jak na vlastní makro:

Pointery II. Jan Hnilica Počítačové modelování 17

Jazyk C práce se soubory. Jan Hnilica Počítačové modelování 16

PA152. Implementace databázových systémů

Příklad : String txt1 = new String( Ahoj vsichni! ); //vytvoří instanci třídy String a přiřadí ji vnitřní hodnotu Ahoj vsichni!

Knihovna RecDBXLib ZÁZNAMY V DATABOXU TXV

17. července :51 z moravec@yahoo.com

1. lekce. do souboru main.c uložíme následující kód a pomocí F9 ho zkompilujeme a spustíme:

Lineární datové struktury

Více o konstruktorech a destruktorech

O datových typech a jejich kontrole

Proměnná. Datový typ. IAJCE Cvičení č. 3. Pojmenované místo v paměti sloužící pro uložení hodnoty.

Datové typy a struktury

Čtvrtek 8. prosince. Pascal - opakování základů. Struktura programu:

VISUAL BASIC. Práce se soubory

Př. další použití pointerů

Empty, Null, Nothing, Missing, prázdný řetězec a buňka

Práce se soubory. Základy programování 2 Tomáš Kühr

IPA - Lab.1 Úvod do programování v ASM

Pokročilé programování v jazyce C pro chemiky (C3220) Operátory new a delete, virtuální metody

Implementace LL(1) překladů

Základy programování (IZP)

Logické operace. Datový typ bool. Relační operátory. Logické operátory. IAJCE Přednáška č. 3. může nabýt hodnot: o true o false

K8055D.DLL v Technická příručka. Úvod. Obecné. Konvence volání. Nastavení adresy karty

ZPRO v "C" Ing. Vít Hanousek. verze 0.3

Spojová implementace lineárních datových struktur

1. lekce. do souboru main.c uložíme následující kód a pomocí F9 ho zkompilujeme a spustíme:

Uživatelské příkazy: false - dialog ukončen IDCANCEL. Vytvoří nové okno. title - titulek okna

1. Umístěte kurzor do sloupce Datový typ na řádek s polem, ve kterém vytvořit chcete seznam.

Základní popis Toolboxu MPSV nástroje

DUM 06 téma: Tvorba makra pomocí VBA

POČÍTAČE A PROGRAMOVÁNÍ

02. HODINA. 2.1 Typy souborů a objektů. 2.2 Ovládací prvky Label a TextBox

zapište obslužnou metodu události Click tlačítka a vyzkoušejte chování polevýsledek.text = polečíslo1.text + polečíslo2.text;

Úvod do MS Access. Modelování v řízení. Ing. Petr Kalčev

Tabulková data. budeme pracovat s CSV soubory položky oddělené středníkem, např.

Pantek Productivity Pack. Process Data Logger. Uživatelský manuál

Inovace výuky prostřednictvím ICT v SPŠ Zlín, CZ.1.07/1.5.00/ Vzdělávání v informačních a komunikačních technologií

Skripta ke školení. Základy VBA. vypracoval: Tomáš Herout. tel:

Úvod do jazyka C. Ing. Jan Fikejz (KST, FEI) Fakulta elektrotechniky a informatiky Katedra softwarových technologií

RELAČNÍ DATABÁZE ACCESS

Bitmaps SPRÁVCE BITMAP A POMOCNÉ FUNKCE PRO PRÁCI S BITMAPAMI. Příručka uživatele a programátora

Microsoft. Access. Nová databáze, návrh tabulky. Mgr. Jan Veverka Střední odborná škola sociální Evangelická akademie

Pokročilé programování v jazyce C pro chemiky (C3220) Třídy v C++

Úvod do programování. Lekce 1

Pole stručný úvod do začátku, podrobně později - zatím statická pole (ne dynamicky) - číslují se od 0

Připravil: David Procházka. Vertex Buffer Objects

PHP - úvod. Kapitola seznamuje se základy jazyka PHP a jeho začleněním do HTML stránky.

Popis ovládání. Po přihlášení do aplikace se objeví navigátor. Navigátor je stromově seřazen a slouží pro přístup ke všem oknům celé aplikace.

Český účetní standard č. 708 Odpisování dlouhodobého majetku

Strukturované typy a ukazatele. Úvod do programování 1 Tomáš Kühr

Programování v jazyce C a C++

Úvod do programování 6. hodina

Programování v C++ 2, 4. cvičení

Databázové a informační systémy Informační systém prodejny nábytku. Jakub Kamrla, KAM087

Cvičení č. 2. Komunikace mezi procesy Program Hodiny. 4 body

VYTVÁŘENÍ DATABÁZÍ, VKLÁDÁNÍ ÚDAJŮ

Konvertor diakritiky 3. Instalace

Microsoft Office. Excel vyhledávací funkce

Programování ve Windows Dynamické knihovny. Andrea Číková Martin Osovský

ucomm JEDNOTKA ZPROSTŘEDKOVÁVAJÍCÍ SLUŽBY BIOSU KITV40 PRO SÉRIOVOU KOMUNIKACI Příručka uživatele a programátora

DSL manuál. Ing. Jan Hranáč. 27. října V této kapitole je stručný průvodce k tvorbě v systému DrdSim a (v

Kurz Databáze. Obsah. Návrh databáze E-R model. Datová analýza, tabulky a vazby. Doc. Ing. Radim Farana, CSc.

NAHLAŠOVÁNÍ UBYTOVANÝCH CIZINCŮ PŘES PORTÁL UBYPORT

Pole a kolekce. v C#, Javě a C++

Programování v jazyce JavaScript

PŘETĚŽOVÁNÍ OPERÁTORŮ

MBus Explorer MULTI. Uživatelský manuál V. 1.1

Knihovna DebugComLib

ADT/ADS = abstraktní datové typy / struktury

Aplikace Embedded systémů v Mechatronice. Michal Bastl A2/713a

24 Uživatelské výběry

Manuál pro mobilní aplikaci. Patron-Pro

DUM 07 téma: Proměnné, konstanty a pohyb po buňkách ve VBA

Manuál. Omluvenky online

Transkript:

Popis funkcí exportovaných z knihovny nddbe.dll Tato příloha obsahuje stručný popis jednotlivých funkcí dynamické knihovny nddbe.dll určené pro práci s datovými soubory aplikace Dorg. NDBAddEntry, NDBAddAEntry, NDBAddUEntry Funkce slouží k přidání nového záznamu do souboru. DWORD NDBAddEntry( LPODBS, PDBITEM pdbitemstruct, DWORD dwflags pdbitemstruct Pointer na strukturu DBITEM obsahující záznam, jenž má být přidán do souboru. dwflags Další volby funkce. Může nabývat hodnoty NDB_ADINODUPLDATE (výchozí, nepovolí duplicitní data funkce vrátí chybovou hodnotu), NDB_ADIOWDUPLDATE (vyhledá případné duplicitní záznamy a přepíše je), NDB_ADIALLOWDUPL (povolí duplicitní data). Funkce NDBAddAEntry a NDBAddUEntry jsou totožné, pouze je jiný druhý parametr místo PDBITEM je PDBAITEM resp. PDBUITEM. NDBCloseFile Funkce zavírá otevřený datový soubor. BOOL NDBCloseFile( LPODBS & Pokud funkce uspěje, vrátí hodnotu TRUE, pokud ne, vrátí FALSE. Po ukončení práce se souborem je nutné tuto funkci zavolat, aby došlo k uvolnění vytvořených objektů v paměti. - 1 -

NDBCreateFile Příloha č. 2 Popis funkcí knihovny nddbe.dll Funkce slouží k vytvoření nového datového souboru nebo změně hlavičky souboru. DWORD NDBCreateFile( LPCTSTR lpfilepath, LPODBS &, DWORD dwflags, PDBHEAD pdbh lpfilepath Pointer na nulou ukončený řetězec, obsahující jméno souboru, resp. celou cestu k souboru. Proměnná typu LPODBS identifikující nově vytvořený datový soubor. dwflags Upřesňuje požadovanou činnost funkce. Může nabývat tyto hodnoty: NDB_CRMCREATE (bude vytvořen nový soubor, pokud soubor existuje, bude přepsán), NDB_CRMCHANGEHEAD (umožní změnu hlavičky a otevře soubor pro zápis), NDB_CRMCLEAR (otevře existující soubor pro zápis, ale odstraní všechny existující záznamy v souboru, ponechá hlavičku). pdbh Pointer na strukturu DBHEAD obsahující data hlavičky souboru. NDBDelEntry Funkce odstraní ze souboru aktuální záznam. DWORD NDBDelEntry( LPODBS & Pokud funkce uspěje vrátí hodnotu NDB_SUCCESS, pokud ne, vrátí nenulovou hodnotu určující chybu, k níž došlo. NDBGetEntry, NDBGetAEntry, NDBGetUEntry Funkce přečte aktuální záznam ze souboru a uloží do struktury DBITEM. DWORD NDBGetEntry( LPODBS, PDBITEM pdbitemstruct - 2 -

pdbitemstruct Pointer na strukturu DBITEM, do níž bude vložen aktuální záznam. Funkce NDBGetAEntry a NDBGetUEntry jsou totožné, pouze je jiný druhý parametr místo PDBITEM je PDBAITEM resp. PDBUITEM. NDBGetCountEntries Vrací počet záznamů v souboru. UINT NDBGetCountEntries( LPODBS Hodnota počtu záznamů v souboru. NDBGetCurrentPos Vrací pozici aktuálního záznamu v souboru. UINT NDBGetCurrentPos( LPODBS Pozice aktuálního záznamu v souboru. Pokud vrátí nulu, došlo k chybě. NDBGetDataArrayPtr Funkce vrací pointer na datovou strukturu otevřeného souboru. PVOID NDBGetDataArrayPtr( LPODBS - 3 -

Pointer ukazující do otevřeného souboru na první záznam (za hlavičku souboru). Pokud vrátí NULL, nejsou v souboru žádné záznamy. Tato funkce je užitečná, pokud je nutné nějakým způsobem pracovat přímo s datovou strukturou souboru. Nedoporučuje se používat pro činnosti, které mohou provádět jiné funkce knihovny, protože obsahují řadu bezpečnostních a kontrolních mechanismů, na rozdíl od přímého zásahu do souboru. Tato funkce rovněž není dostupná pro datový soubor typu NDB_DBTYPE_ORGANIZER. NDBGetHead Funkce slouží k přečtení hlavičky souboru. BOOL NDBGetHead( LPODBS, PDBHEAD pdbh pdbh Pointer na strukturu DBHEAD, do níž bude vložena hlavička souboru. Pokud funkce uspěje, vrátí hodnotu TRUE, pokud ne, vrátí FALSE. NDBGetInfo Získání všech informací o otevřeném souboru. BOOL NDBGetInfo( LPODBS, LPINFODBS lpinfo lpinfo Pointer na strukturu INFODBSTRUCT, jejíž položky funkce vyplní informacemi o souboru. Pokud funkce uspěje, vrátí hodnotu TRUE, pokud ne, vrátí FALSE. - 4 -

NDBChangeEntry, NDBChangeAEntry, NDBChangeUEntry Změní (přepíše) aktuální záznam databáze. DWORD NDBChangeEntry( LPODBS, PDBITEM pdbitemstruct pdbitemstruct Pointer na strukturu DBITEM obsahující záznam, jímž bude aktuální záznam přepsán. Funkce NDBChangeAEntry a NDBChangeUEntry jsou totožné, pouze je jiný druhý parametr místo PDBITEM je PDBAITEM resp. PDBUITEM. NDBIsBOF Slouží ke zjištění, zda bylo dosaženo začátku souboru (prvního záznamu). BOOL NDBIsBOF( LPODBS Vrací TRUE, pokud je aktuální záznam první záznam v souboru, jinak FALSE. NDBIsEOF Slouží ke zjištění, zda bylo dosaženo konce souboru (posledního záznamu). BOOL NDBIsEOF( LPODBS Vrací TRUE, pokud je aktuální záznam poslední záznam v souboru, jinak FALSE. - 5 -

NDBMoveFirst Příloha č. 2 Popis funkcí knihovny nddbe.dll Nastaví aktuální záznam na první záznam souboru. BOOL NDBMoveFirst( LPODBS Vrací FALSE, pokud v souboru nejsou žádné záznamy. NDBMoveLast Nastaví aktuální záznam na poslední záznam souboru. BOOL NDBMoveLast( LPODBS Vrací FALSE, pokud v souboru nejsou žádné záznamy. NDBMoveNext Nastaví aktuální záznam na následující záznam souboru. BOOL NDBMoveNext( LPODBS Vrací FALSE, pokud v souboru nejsou žádné záznamy nebo je dosaženo konce souboru. NDBMovePrevious Nastaví aktuální záznam na předchozí záznam souboru. BOOL NDBMovePrevious( LPODBS - 6 -

Vrací FALSE, pokud v souboru nejsou žádné záznamy nebo je dosaženo začátku souboru. NDBOpenFile Funkce otevře existující soubor. DWORD NDBOpenFile( LPCTSTR lpfilepath, LPODBS &, DWORD dwflags lpfilepath Pointer na nulou ukončený řetězec, obsahující jméno souboru, resp. celou cestu k souboru. Proměnná typu LPODBS identifikující nově otevřený datový soubor. dwflags Určuje možnosti otevření souboru. Může nabývat tyto hodnoty: NDB_RWMREAD (soubor bude otevřen pouze pro čtení), NDB_RWMWRITE (soubor bude otevřen pro čtení i zápis), NDB_RWMOPEN (otevře soubor pro čtení, ale načtena bude pouze hlavička, záznamy ne). NDBSaveFile Funkce uloží otevřený soubor. DWORD NDBSaveFile( LPODBS &, BOOL bclose bclose Pokud je tento parametr nastaven na TRUE, bude soubor po uložení zavřen (jako by byla volána funkce NDBCloseFile). Pokud na FALSE, soubor zůstane po uložení otevřen. Veškeré změny provedené v otevřeném souboru jsou ukládány do dočasného bufferu. Fyzicky - 7 -

se změny uloží do souboru až po zavolání této funkce. NDBSetCurrentPos Přímé nastavení aktuálního záznamu v souboru. BOOL NDBSetCurrentPos( LPODBS, UINT unewpos unewpos Nová pozice aktuálního záznamu v souboru. Záznamy jsou číslovány od 1. Pokud funkce vrátí FALSE, pravděpodobně byl zadán chybný index záznamu (počet záznamů je menší). Tuto funkci není moc vhodné používat. Pro procházení záznamů v souboru je lepší použít funkcí NDBMove***. NDBSetDefaultHeadData Vyplní výchozí hodnoty hlavičky souboru strukturu DBHEAD. BOOL NDBSetDefaultHeadData( PDBHEAD pdbh pdbh Pointer na strukturu DBHEAD. Pokud funkce uspěje, vrátí hodnotu TRUE, pokud ne, vrátí FALSE. Slouží ke zjednodušení práce při vytváření nového souboru pomocí funkce NDBCreateFile, aby se nemusely jednotlivé informace obsažené v hlavičce vyplňovat ručně. - 8 -

Funkce pro soubor hlavní databáze činností Základní postupy jsou shodné s výše uvedenými, pouze je jiné pojmenování funkcí. Všechny funkce určené pro soubory tohoto typu začínají písmeny NDBOrg + název funkce. Např. funkce NDBOrgOpenFile je obdoba funkce NDBOpenFile a jejich činnost a použití je totožné. Jsou zde pouze 2 funkce navíc: NDBOrgGetEntrySize Tato funkce zjistí celkovou velikost (v bajtech) aktuálního záznamu, včetně kontrolního bajtu. DWORD NDBOrgGetEntrySize( LPODBS, LPDWORD lpdwlength lpdwlength Pointer na proměnnou typu DWORD, do níž bude vložena velikost záznamu. Tato funkce byla vytvořena, protože velikost každého záznamu v tomto typu souboru může být jiná na rozdíl od ostatních typů souborů, kde je konstantní. NDBOrgHashData Tato funkce zajišťuje propočtení začátků jednotlivých záznamů v souboru. Tuto činnost je nutné provést po každé změně v souboru. Knihovní funkce, ale toto dělají automaticky. DWORD NDBOrgHashData( LPODBS, BOOL bignorectrlbyte = FALSE bignorectrlbyte Musí být nastaven na hodnotu FALSE. - 9 -

Jedná se o funkci pro vnitřní účely knihovny. Exportována je pouze pro případ, že bylo zapotřebí vytvořit vlastní funkce pro úpravu záznamů v souboru, což v případě hlavní databáze činností není doporučeno. Další možnost je využít této funkce pro kontrolu souboru, zda se v něm nevyskytují chyby. PŘI POUŽITÍ FUNKCÍ KNIHOVNY NENÍ NUTNÉ NIKDY TUTO FUNKCI VOLAT. Použité datové typy a struktury jsou deklarovány v příslušných hlavičkových souborech, kde jsou i popsány jednotlivé položky. Rovněž jsou v nich definována použitá makra a konstanty. - 10 -