PtConfigDb.h

Go to the documentation of this file.

//
// Copyright (C) 2004-2006 SIPfoundry Inc.
// Licensed by SIPfoundry under the LGPL license.
//
// Copyright (C) 2004-2006 Pingtel Corp.  All rights reserved.
// Licensed to SIPfoundry under a Contributor Agreement.
//
// $$


#ifndef _PtConfigDb_h_
#define _PtConfigDb_h_

// SYSTEM INCLUDES
#include <stdio.h>

// APPLICATION INCLUDES
#include "PtDefs.h"

// DEFINES
// MACROS
// EXTERNAL FUNCTIONS
// EXTERNAL VARIABLES
// CONSTANTS
// STRUCTS
// TYPEDEFS
// FORWARD DECLARATIONS

//:Configuration database containing key/value pairs.
// This class maintains a dictionary of key/value pairs.

class PtConfigDb
{
/* //////////////////////////// PUBLIC //////////////////////////////////// */
public:

/* ============================ CREATORS ================================== */

   PtConfigDb();
     //:Default constructor

   virtual
   ~PtConfigDb();
     //:Destructor

/* ============================ MANIPULATORS ============================== */

   PtStatus loadFromFile(FILE* fp);
     //:Load the configuration database from a file

   PtStatus storeToFile(FILE* fp);
     //:Store the config database to a file

   PtStatus remove(const char* pKey);
     //:Remove the key/value pair associated with pKey.

   PtStatus set(const char* pKey, const char* pNewValue);
     //:Insert the key/value pair into the config database.
     // If the database already contains an entry for this key, then 
     // set the value for the existing entry to pNewValue.

/* ============================ ACCESSORS ================================= */

   PtStatus get(const char* pKey, char*& rpValue);
     //:Sets <i>rpValue</i> to point to the value in the database 
     //:associated with <i>pKey</i>.
     // If pKey is found in the database, returns PT_SUCCESS.  Otherwise,
     // returns PT_NOT_FOUND and sets rpValue to point to an empty string.

   PtStatus get(const char* pKey, int& rValue);
     //:Sets <i>rValue</i> to the integer value in the database associated 
     //:with <i>pKey</i>.
     // If pKey is found in the database, returns PT_SUCCESS.  Otherwise,
     // returns PT_NOT_FOUND and sets rValue to -1.

   PtStatus getNext(const char* pKey,
                    char*& rpNextKey, char*& rpNextValue);
     //:Relative to <i>pKey</i>, sets <i>rpNextKey</i> and 
     //:<i>rpNextValue</i> to point to the key and value associated with 
     //:next (lexicographically ordered) key/value pair stored in the 
     //:database.  
     // If pKey is the empty string, the key and value associated 
     // with the first entry in the database will be returned.

/* ============================ INQUIRY =================================== */

   PtStatus isEmpty(PtBoolean& rIsEmpty);
     //:Sets <i>rIsEmpty</i> to TRUE if the database is empty, otherwise 
     //:FALSE.

   PtStatus numEntries(int& rNumEntries);
     //:Sets <i>rNumEntries</i> to the number of entries in the config database

/* //////////////////////////// PROTECTED ///////////////////////////////// */
protected:

/* //////////////////////////// PRIVATE /////////////////////////////////// */
private:

};

/* ============================ INLINE METHODS ============================ */

#endif  // _PtConfigDb_h_