edb_util - EPOCH Events Database Utilities

The EDB_UTIL functions are used to load and access an EPOCH events database. The events database is defined in an ASCII flat file:

    eventName eventNumber "text" priority
    eventName eventNumber "text" priority

The database is loaded from the file into memory as follows:

    #include  <stdio.h>				-- Standard I/O definitions.
    #include  "edb_util.h"			-- EPOCH events database.
    EventsDB  database ;
    edbCreate ("fileName", &database) ;

Once the database is loaded, an event message can be formatted using the database-defined template for the event:

    int  number ;				-- Event number.
    NVarSet  data ;				-- Dynamic data.
    printf ("(%s) %s\n",
            edbName (database, number),
            edbFormat (database, number, data)) ;

Dynamic data fields in the template ("$name" or "$(name)") are replaced by the corresponding value retrieved from the set of named variables passed into edbFormat().

Event numbers can converted to their textual names and vice-versa:

    number = edbNumber (database, "name") ;
    printf ("Event #%d = \"%s\"\n",
            number, edbName (database, number)) ;

Public Procedures

edbCreate() - creates a memory-resident, EPOCH events database.
edbDestroy() - deletes a database.
edbFile() - returns the database's name.
edbFormat() - formats an event message.
edbLoad() - loads an EPOCH events database.
edbName() - converts an event number to its name.
edbNumber() - converts an event name to its number.
edbText() - returns an event's text template.

Source Files


Alex Measday  /  E-mail