C/C++ User's Journal STLSoft - ... Robust, Lightweight, Cross-platform, Template Software ... ATLSTL - where the Standard Template Library meets the Active Template Library COMSTL - where the Standard Template Library meets the Component Object Model
Synesis Software InetSTL - where the Standard Template Library meets the Internet UNIXSTL - Template Software for the UNIX Operating System WinSTL - where the Standard Template Library meets the Win32 API

Main Page   Modules   Namespace List   Class Hierarchy   Alphabetical List   Compound List   File List   Namespace Members   Compound Members   File Members   Related Pages  

Using recls in C

recls is written in C, and expresses a C-API, so programming in C means programming to the core API.

There are two sample programs provided:

C_simple

This sample/test program, located in the test/C_simple subdirectory, shows a minimal use of the API, to load a memory database (from a literal string), display information about the database (# of lines, fields, records), and then enumerate the records and their constituent fields.

It performs these tasks twice, demonstrating the use of the raw data structures, and of the API functions.

C_full

This sample/test program, located in the test/C_full subdirectory, shows a full use of the C-API, including error-handling and use of the file-database function to load a file named on the command-line. It also allows the specification of the ORJ_FLAG_ORDERFIELDS and/or ORJ_FLAG_ELIDEBLANKRECORDS flags, via the command-line, which can moderate the database contents as expressed by the API.

This program has various aspects that are peripheral to the quick absorption of the API, and should be examined and tested after C_simple.


recls Library documentation © Synesis Software Pty Ltd, 2001-2005