Product Documentation

c-treeDB API for C

Previous Topic

Next Topic

Tutorial 1: Introductory Tutorial

drivers\c.nav\tutorials\ctdb_tutorial1.c

This tutorial will take you through the basic use of the c-treeDB API for C.

As with all other examples in the c-tree tutorial series, this tutorial simplifies the creation and use of a database into four simple steps: Initialize(), Define(), Manage(), and You’re Done() !

Tutorial #1: Introductory - Simple Single Table

We wanted to keep this program as simple as possible. This program does the following:

  • Initialize() - Connects to the FairCom Database Engine.
  • Define() - Defines and creates a "customer master" (custmast) table/file.
  • Manage() - Adds a few rows/records; Reads the rows/records back from the database; displays the column/field content; and then deletes the rows/records.
  • Done() - Disconnects from FairCom Database Engine.

Note our simple Main() function:

/*

* main()

*

* The main() function implements the concept of "init, define, manage

* and you're done..."

*/

#ifdef PROTOTYPE

NINT main (COUNT argc, pTEXT argv[])

#else

NINT main (argc, argv)

COUNT argc;

TEXT argv[];

#endif

{

Initialize();

Define();

Manage();

Done();

printf("\nPress <ENTER> key to exit . . .\n");

#ifndef ctPortWINCE

getchar();

#endif

return(0);

}

We suggest opening the source code with your own editor.

Continue now to review these four steps.

In This Section

Init

Define

Manage

Done

TOCIndex