FX::FXDict Class Reference

#include <FXDict.h>

Inheritance diagram for FX::FXDict:

Public Member Functions
	FXDict ()
	FXDict (const FXDict &orig)
FXDict &	operator= (const FXDict &orig)
void	size (FXint m)
FXint	size () const
FXint	no () const
void *	insert (const FXchar *ky, const void *ptr, bool mrk=false)
void *	replace (const FXchar *ky, const void *ptr, bool mrk=false)
void *	remove (const FXchar *ky)
void *	find (const FXchar *ky) const
bool	empty (FXint pos) const
const FXchar *	key (FXuint pos) const
void *	data (FXuint pos) const
bool	mark (FXuint pos) const
FXint	first () const
FXint	last () const
FXint	next (FXint pos) const
FXint	prev (FXint pos) const
void	clear ()
virtual	~FXDict ()
Public Member Functions inherited from FX::FXObject
virtual long	onDefault (FXObject *, FXSelector, void *)
const FXchar *	getClassName () const
bool	isMemberOf (const FXMetaClass *metaclass) const
virtual long	tryHandle (FXObject *sender, FXSelector sel, void *ptr)
virtual void	save (FXStream &store) const
virtual void	load (FXStream &store)
virtual	~FXObject ()

Detailed Description

The dictionary class maintains a fast-access hash table of entities indexed by a character string.

It is typically used to map strings to pointers; however, overloading the createData() and deleteData() members allows any type of data to be indexed by strings.

Constructor & Destructor Documentation

FX::FXDict::FXDict

(

)

Construct an empty dictionary.

FX::FXDict::FXDict

(

const FXDict &

orig

)

Copy constructor; does bit-copy of void pointer data.

virtual FX::FXDict::~FXDict ( )

virtual

Destructor.

Member Function Documentation

FXDict& FX::FXDict::operator=

(

const FXDict &

orig

)

Assignment operator.

void FX::FXDict::size

(

FXint

m

)

Resize the table to the given size.

FXint FX::FXDict::size ( ) const

inline

Return the size of the table, including the empty slots.

FXint FX::FXDict::no ( ) const

inline

Return the total number of entries in the table.

void* FX::FXDict::insert	(	const FXchar *	ky,
		const void *	ptr,
		bool	mrk = false
	)

Insert a new entry into the table given key and mark.

If there is already an entry with that key, leave it unchanged, otherwise insert the new entry.

Referenced by FX::FXStringDict::insert(), and FX::FXIconDict::insert().

void* FX::FXDict::replace	(	const FXchar *	ky,
		const void *	ptr,
		bool	mrk = false
	)

Replace data at key, if the entry's mark is less than or equal to the given mark.

If there was no existing entry, a new entry is inserted with the given mark.

Referenced by FX::FXStringDict::replace().

void* FX::FXDict::remove

(

const FXchar *

ky

)

Remove data given key.

Referenced by FX::FXStringDict::remove(), and FX::FXIconDict::remove().

void* FX::FXDict::find

(

const FXchar *

ky

)

const

Find data pointer given key.

Referenced by FX::FXStringDict::find(), FX::FXSettings::find(), and FX::FXIconDict::find().

bool FX::FXDict::empty ( FXint  pos ) const

inline

Return true if slot is empty.

const FXchar* FX::FXDict::key ( FXuint  pos ) const

inline

Return key at position pos.

void* FX::FXDict::data ( FXuint  pos ) const

inline

return data pointer at position pos.

Referenced by FX::FXSettings::data().

bool FX::FXDict::mark ( FXuint  pos ) const

inline

Return mark flag of entry at position pos.

FXint FX::FXDict::first

(

)

const

Return position of first filled slot, or >= total.

FXint FX::FXDict::last

(

)

const

Return position of last filled slot or -1.

FXint FX::FXDict::next

(

FXint

pos

)

const

Return position of next filled slot in hash table or a value greater than or equal to total if no filled slot was found.

FXint FX::FXDict::prev

(

FXint

pos

)

const

Return position of previous filled slot in hash table or a -1 if no filled slot was found.

void FX::FXDict::clear

(

)

Clear all entries.