BALL::ResourceFile Class Reference
[Support for hierarchical text data.]

#include <BALL/FORMAT/resourceFile.h>

Inheritance diagram for BALL::ResourceFile:

List of all members.

Public Types
typedef Entry::Iterator	Iterator
typedef Entry::ConstIterator	ConstIterator
Type Definition
typedef ResourceEntry	Entry
Public Member Functions
Iterator	begin ()
Iterator	end ()
ConstIterator	begin () const
ConstIterator	end () const
Constructors and Destructors
	ResourceFile ()
	ResourceFile (const String &name) throw (Exception::FileNotFound)
	ResourceFile (const ResourceFile &file) throw (Exception::FileNotFound)
virtual	~ResourceFile ()
void	destroy ()
virtual void	clear ()
Accessors
Size	getSize () const
Entry &	getRoot ()
const Entry &	getRoot () const
Entry *	getEntry (const String &key_path)
const Entry *	getEntry (const String &key_path) const
String *	getValue (const String &key_path)
const String *	getValue (const String &key_path) const
Entry *	insert (const String &key_path, const String &name)
bool	removeKey (const String &key_path)
Attributes
bool	operator== (const ResourceFile &entry) const
bool	operator!= (const ResourceFile &entry) const
bool	hasKey (const String &key_path) const
bool	isEmpty () const
Debugging and Diagnostics
bool	isValid () const
void	dump (std::ostream &s=std::cout, Size depth=0) const
Static Public Attributes
Constants
static char	ENTRY_BEGIN
static char	ENTRY_END
static char	SEPARATOR
Private Member Functions
const ResourceFile &	operator= (const ResourceFile &file)
bool	validateSyntax_ ()
void	skipWhitespaces_ ()
Static Private Member Functions
static void	save_ (File &file, const Entry *entry, Size &depth)
Private Attributes
Entry	root_
Friends
Storers
std::istream &	operator>> (std::istream &s, ResourceFile &resource_file)
File-related methods.
bool	open (const String &name)
void	close ()
void	saveAs (const String &name)
void	save (const Entry &entry)
void	save ()
static void	saveAs (const Entry &entry, const String &name)
Processor and Visitor related methods
void	host (Visitor< ResourceFile > &visitor)
bool	apply (UnaryProcessor< Entry > &processor)
static bool	applyChildren (Entry &entry, UnaryProcessor< Entry > &processor)

---

Detailed Description

Resource file class

---

Member Typedef Documentation

typedef Entry::ConstIterator BALL::ResourceFile::ConstIterator

typedef ResourceEntry BALL::ResourceFile::Entry

typedef Entry::Iterator BALL::ResourceFile::Iterator

---

Constructor & Destructor Documentation

BALL::ResourceFile::ResourceFile

(

)

Default constructor

BALL::ResourceFile::ResourceFile

(

const String &

name

)

throw (Exception::FileNotFound)

Detailed constructor.

BALL::ResourceFile::ResourceFile

(

const ResourceFile &

file

)

throw (Exception::FileNotFound)

Copy constructor

virtual BALL::ResourceFile::~ResourceFile

(

)

[virtual]

Destructor

---

Member Function Documentation

bool BALL::ResourceFile::apply

(

UnaryProcessor< Entry > &

processor

)

static bool BALL::ResourceFile::applyChildren	(	Entry &	entry,
		UnaryProcessor< Entry > &	processor
	)			[static]

ConstIterator BALL::ResourceFile::begin

(

)

const [inline]

Iterator BALL::ResourceFile::begin

(

)

[inline]

virtual void BALL::ResourceFile::clear

(

)

[virtual]

Clear method

Reimplemented from BALL::File.

void BALL::ResourceFile::close

(

)

Close the file.

Reimplemented from BALL::File.

void BALL::ResourceFile::destroy

(

)

Destroy method

void BALL::ResourceFile::dump	(	std::ostream &	s = std::cout,
		Size	depth = 0
	)			const

ConstIterator BALL::ResourceFile::end

(

)

const [inline]

Iterator BALL::ResourceFile::end

(

)

[inline]

const Entry* BALL::ResourceFile::getEntry

(

const String &

key_path

)

const

Entry* BALL::ResourceFile::getEntry

(

const String &

key_path

)

const Entry& BALL::ResourceFile::getRoot

(

)

const

Entry& BALL::ResourceFile::getRoot

(

)

Size BALL::ResourceFile::getSize

(

)

const

const String* BALL::ResourceFile::getValue

(

const String &

key_path

)

const

String* BALL::ResourceFile::getValue

(

const String &

key_path

)

bool BALL::ResourceFile::hasKey

(

const String &

key_path

)

const

void BALL::ResourceFile::host

(

Visitor< ResourceFile > &

visitor

)

Entry* BALL::ResourceFile::insert	(	const String &	key_path,
		const String &	name
	)

bool BALL::ResourceFile::isEmpty

(

)

const

bool BALL::ResourceFile::isValid

(

)

const

Test if the file is valid. If the filename was not set, false is returned. This function uses std::fstream::good().

Returns:

bool true if the file is valid

Reimplemented from BALL::File.

bool BALL::ResourceFile::open

(

const String &

name

)

bool BALL::ResourceFile::operator!=

(

const ResourceFile &

entry

)

const

Inequality operator

const ResourceFile& BALL::ResourceFile::operator=

(

const ResourceFile &

file

)

[private]

bool BALL::ResourceFile::operator==

(

const ResourceFile &

entry

)

const

Equality operator

bool BALL::ResourceFile::removeKey

(

const String &

key_path

)

void BALL::ResourceFile::save

(

)

void BALL::ResourceFile::save

(

const Entry &

entry

)

static void BALL::ResourceFile::save_	(	File &	file,
		const Entry *	entry,
		Size &	depth
	)			[static, private]

void BALL::ResourceFile::saveAs

(

const String &

name

)

static void BALL::ResourceFile::saveAs	(	const Entry &	entry,
		const String &	name
	)			[static]

void BALL::ResourceFile::skipWhitespaces_

(

)

[private]

bool BALL::ResourceFile::validateSyntax_

(

)

[private]

---

Friends And Related Function Documentation

std::istream& operator>>	(	std::istream &	s,
		ResourceFile &	resource_file
	)			[friend]

---

Member Data Documentation

char BALL::ResourceFile::ENTRY_BEGIN [static]

char BALL::ResourceFile::ENTRY_END [static]

Entry BALL::ResourceFile::root_ [private]

char BALL::ResourceFile::SEPARATOR [static]