ucommon::keyfile Class Reference

Traditional keypair config file parsing class. More...

#include <keydata.h>

Inheritance diagram for ucommon::keyfile:

Collaboration diagram for ucommon::keyfile:

Public Types
typedef linked_pointer< keydata >	iterator
	Convenience typedef for iterative pointer.
Public Member Functions
keydata *	begin (void) const
	Get first keydata object, for iterative examinations.
keydata *	end (void) const
	Get last keydata object, for iterative examinations.
int	err (void)
keydata *	get (const char *section) const
	Get a keydata section name.
keydata *	get (void) const
	Get the non-sectioned defaults if there are any.
	keyfile (size_t pagesize=0)
	Create an empty key file ready for loading.
	keyfile (const char *path, size_t pagesize=0)
	Create a key file object from an existing config file.
	keyfile (const keyfile &copy, size_t pagesize=0)
void	load (const char *path)
	Load (overlay) another config file over the currently loaded one.
void	load (const keyfile *source)
	Load from an existing keyfile object.
void	load (const keydata *source)
	Load a single set of keys.
keydata *	operator() (const char *section) const
keydata *	operator[] (const char *section) const
void	release (void)
	Release and re-initialize keyfile.
bool	save (const char *path)
	Save (write) a set of config keys to dist.
Protected Member Functions
keydata *	create (const char *section)
Friends
class	keydata

---

Detailed Description

Traditional keypair config file parsing class.

This is used to get generic config data either from a /etc/xxx.conf, a windows style xxx.ini file, or a ~/.xxxrc file, and parses [] sections from the entire file at once.

---

Constructor & Destructor Documentation

ucommon::keyfile::keyfile

(

size_t

pagesize = 0

)

Create an empty key file ready for loading.

Parameters:

pagesize

for memory paging.

ucommon::keyfile::keyfile	(	const char *	path,
		size_t	pagesize = 0
	)

Create a key file object from an existing config file.

Parameters:

path	to load from.
pagesize	for memory paging.

---

Member Function Documentation

keydata* ucommon::keyfile::begin

(

void

)

const [inline]

Get first keydata object, for iterative examinations.

Returns:

first key value in chain.

Definition at line 238 of file keydata.h.

Here is the call graph for this function:

keydata* ucommon::keyfile::end

(

void

)

const [inline]

Get last keydata object, for iterative examinations.

Returns:

first key value in chain.

Definition at line 245 of file keydata.h.

keydata* ucommon::keyfile::get

(

const char *

section

)

const

Get a keydata section name.

Parameters:

section

name to look for.

Returns:

keydata section object if found, NULL if not.

keydata* ucommon::keyfile::get

(

void

)

const [inline]

Get the non-sectioned defaults if there are any.

Returns:

default key section.

Definition at line 231 of file keydata.h.

void ucommon::keyfile::load

(

const char *

path

)

Load (overlay) another config file over the currently loaded one.

This is used to merge key data, such as getting default values from a global config, and then overlaying a local home config file.

Parameters:

path	to load keys from into current object.

void ucommon::keyfile::load

(

const keyfile *

source

)

Load from an existing keyfile object.

Parameters:

source

to copy from.

void ucommon::keyfile::load

(

const keydata *

source

)

Load a single set of keys.

Parameters:

source

of keys to copy.

bool ucommon::keyfile::save

(

const char *

path

)

Save (write) a set of config keys to dist.

Parameters:

path	of file to save keys to.

Returns:

true on success.

---

The documentation for this class was generated from the following file:

• ucommon/keydata.h