GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  WORDCONTEXT (3)

NAME

WordContext -

read configuration and setup mifluz context.

CONTENTS

Synopsis
Description
Configuration
Methods
Environment
Authors
See Also

SYNOPSIS


#include <mifluz.h>

WordContext context;

DESCRIPTION

The WordContext object must be the first object created. All other objects (WordList, WordReference, WordKey and WordRecord) are allocated via the corresponding methods of WordContext (List, Word, Key and Record respectively).

The WordContext object contains a Configuration object that holds the configuration parameters used by the instance. If a configuration parameter is changed, the ReInitialize method should be called to take them in account.

CONFIGURATION

For more information on the configuration attributes and a complete list of attributes, see the mifluz(3) manual page.
wordlist_monitor {true|false} (default false)
  If true create a WordMonitor instance to gather statistics and build reports.

METHODS

WordContext()
  Constructor. Read the configuration parameters from the environment. If the environment variable MIFLUZ_CONFIG is set to a pathname, read it as a configuration file. If MIFLUZ_CONFIG is not set, try to read the ~/.mifluz configuration file or /usr/etc/mifluz.conf
.See the mifluz manual page for a complete list of the configuration attributes.
WordContext(const Configuration &config)
  Constructor. The config argument must contain all the configuration parameters, no configuration file is loaded from the environment.
WordContext(const ConfigDefaults *array)
  Constructor. The array argument holds configuration parameters that will override their equivalent in the configuration file read from the environment.
void Initialize(const Configuration &config)
  Initialize the WordContext object. This method is called by every constructor.

When calling Initialize a second time, one must ensure that all WordList and WordCursor objects have been destroyed. WordList and WordCursor internal state depends on the current WordContext that will be lost by a second call.

For those interested by the internals, the Initialize function maintains a Berkeley DB environment (DB_ENV) in the following way:

First invocation:


Initialize -> new DB_ENV (thru WordDBInfo)


Second invocation:


Initialize -> delete DB_ENV -> new DB_ENV (thru WordDBInfo)


int Initialize(const ConfigDefaults* config_defaults = 0)
  Initialize the WordContext object. Build a Configuration object from the file pointed to by the MIFLUZ_CONFIG environment variable or ~/.mifluz or /usr/etc/mifluz.conf. The config_defaults argument, if provided, is passed to the Configuration object using the Defaults method. The Initialize(const Configuration &) method is then called with the Configuration object. Return OK if success, NOTOK otherwise. Refer to the Configuration description for more information.
int ReInitialize()
  Destroy internal state except the Configuration object and rebuild it. May be used when the configuration is changed to take these changes in account. Return OK if success, NOTOK otherwise.
const WordType& GetType() const
  Return the WordType data member of the current object as a const.
WordType& GetType()
  Return the WordType data member of the current object.
const WordKeyInfo& GetKeyInfo() const
  Return the WordKeyInfo data member of the current object as a const.
WordKeyInfo& GetKeyInfo()
  Return the WordKeyInfo data member of the current object.
const WordRecordInfo& GetRecordInfo() const
  Return the WordRecordInfo data member of the current object as a const.
WordRecordInfo& GetRecordInfo()
  Return the WordRecordInfo data member of the current object.
const WordDBInfo& GetDBInfo() const
  Return the WordDBInfo data member of the current object as a const.
WordDBInfo& GetDBInfo()
  Return the WordDBInfo data member of the current object.
const WordMonitor* GetMonitor() const
  Return the WordMonitor data member of the current object as a const. The pointer may be NULL if the word_monitor attribute is false.
WordMonitor* GetMonitor()
  Return the WordMonitor data member of the current object. The pointer may be NULL if the word_monitor attribute is false.
const Configuration& GetConfiguration() const
  Return the Configuration data member of the current object as a const.
Configuration& GetConfiguration()
  Return the Configuration data member of the current object.
WordList* List()
  Return a new WordList object, using the WordList(WordContext*) constructor. It is the responsibility of the caller to delete this object before the WordContext object is deleted. Refer to the wordlist_multi configuration parameter to know the exact type of the object created.
WordReference* Word()
  Return a new WordReference object, using the WordReference(WordContext*) constructor. It is the responsibility of the caller to delete this object before the WordContext object is deleted.
WordReference* Word(const String& key0, const String& record0)
  Return a new WordReference object, using the WordReference(WordContext*, const String&, const& String) constructor. It is the responsibility of the caller to delete this object before the WordContext object is deleted.
WordReference* Word(const String& word)
  Return a new WordReference object, using the WordReference(WordContext*, const String&) constructor. It is the responsibility of the caller to delete this object before the WordContext object is deleted.
WordRecord* Record()
  Return a new WordRecord object, using the WordRecord(WordContext*) constructor. It is the responsibility of the caller to delete this object before the WordContext object is deleted.
WordKey* Key()
  Return a new WordKey object, using the WordKey(WordContext*) constructor. It is the responsibility of the caller to delete this object before the WordContext object is deleted.
WordKey* Key(const String& word)
  Return a new WordKey object, using the WordKey(WordContext*, const String&) constructor. It is the responsibility of the caller to delete this object before the WordContext object is deleted.
WordKey* Key(const WordKey& other)
  Return a new WordKey object, using the WordKey(WordContext*, const WordKey&) constructor. It is the responsibility of the caller to delete this object before the WordContext object is deleted.
static String ConfigFile()
  Return the full pathname of the configuration file. The configuration file lookup first searches for the file pointed by the MIFLUZ_CONFIG environment variable then ~/.mifluz and finally /usr/etc/mifluz.conf
.If no configuration file is found, return the empty string.

ENVIRONMENT

MIFLUZ_CONFIG file name of configuration file read by WordContext(3). Defaults to ~/.mifluz. or /usr/etc/mifluz.conf

AUTHORS

Loic Dachary loic@gnu.org

The Ht://Dig group http://dev.htdig.org/

SEE ALSO

htdb_dump(1), htdb_stat(1), htdb_load(1), mifluzdump(1), mifluzload(1), mifluzsearch(1), mifluzdict(1), WordList(3), WordDict(3), WordListOne(3), WordKey(3), WordKeyInfo(3), WordType(3), WordDBInfo(3), WordRecordInfo(3), WordRecord(3), WordReference(3), WordCursor(3), WordCursorOne(3), WordMonitor(3), Configuration(3), mifluz(3)

Search for    or go to Top of page |  Section 3 |  Main Index


--> WORDCONTEXT (3) local

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.