Set of strings.Class NameSet implements a symbol or name table. It allows to store or remove names (i.e., char*), but does not provide means for manipulating stored names. More...

#include <nameset.h>

Classes
class	Name
	Handles of names in a NameSet.Class Name provides the handles (i.e., char*s) of names in a NameSet. More...

Public Member Functions
Inquiry
const char *	operator[] (int pnum) const
	returns `num` 'th name of NameSet.

const char *	operator[] (const DataKey &pkey) const
	returns name for DataKey `pkey` of NameSet.

int	num () const
	returns nr. of names in NameSet.

int	max () const
	returns maximum nr. of names that fit into NameSet.

int	size () const
	returns maximum DataKey::idx used in NameSet.

int	memMax () const
	returns maximum length of string memory.

int	memSize () const
	returns used length of string memory.

DataKey	key (int pnum) const
	returns DataKey of the `pnum` 'th name in NameSet.

DataKey	key (const char *str) const
	returns DataKey of name `str` in NameSet.

int	number (const DataKey &pkey) const
	returns number of name with DataKey `pkey` in NameSet.

int	number (const char *str) const
	returns number of name `str` in NameSet.

bool	has (int pnum) const
	does NameSet has a name with number `pnum`?

bool	has (const char *str) const
	does NameSet has a name `str`?

bool	has (const DataKey &pkey) const
	does NameSet has a name with DataKey `pkey`?

Extension
void	add (const char *str)

void	add (DataKey &key, const char *str)
	adds name `str` to NameSet.

void	add (const NameSet &set)

void	add (DataKey key[], const NameSet &nset)
	adds all names in `set` to NameSet.

Shrinking
void	remove (const DataKey &key)
	removes name with DataKey `key` from NameSet.

void	remove (int pnum)
	removes `pnum` 'th name from NameSet.

void	remove (const char *str)
	removes name `str` from NameSet.

void	remove (const DataKey keys[], int n)
	removes `n` names with DataKeys `keys` from NameSet.

void	remove (const int nums[], int n)
	removes `n` names with numbers `nums` from NameSet.

void	remove (int dstat[])
	remove all entries where `dstat` is less than zero.

void	clear ()
	removes all names from NameSet.

Memory Control
void	reMax (int newmax=0)
	resets max() to `newmax`.

void	memRemax (int newmax=0)
	resets memMax() to `newmax`.

void	memPack ()
	garbage collection.

Miscellaneous
bool	isConsistent () const
	consistency check.

Constructors / Destructors
	NameSet (int max=10000, int mmax=-1, Real fac=2, Real memFac=2)
	default constructor.

	~NameSet ()
	destructor.

Public Attributes
Control Parameters
Real	factor
	memory extension factor for entries.

Real	memFactor
	memory extension factor for names.

Private Member Functions
Blocked
	NameSet (const NameSet &old)
	copy constructor.

NameSet &	operator= (const NameSet &rhs)
	assignment operator.

Private Attributes
Data
DataSet< int >	set
	name set.

char *	mem
	string memory

int	memmax
	size of string memory

int	memused
	size of used string memory

DataHashTable< Name, DataKey >	hashtab
	hashtable for names

Detailed Description

Set of strings.

Class NameSet implements a symbol or name table. It allows to store or remove names (i.e., char*), but does not provide means for manipulating stored names.

Names in a NameSet may be accessed via numbers from 0 through num()-1 and via DataKeys. See DataSet for a description of these concepts.

At a time a NameSet can hold a maximum of max() entries. This can be reset with method reMax(). If more than max() names are added to a NameSet, it adjusts itself automatically to the required size. This implies, that references to names within a NameSet may become invalid if the NameSet is expanded.

All names (i.e., the actual char strings) in a NameSet are stored in one continuous memory block of size memMax(). At one time memSize() bytes of it are used for actually saving names; the remaining memory is free to hold additional names. memRemax() can be used to reset memMax() but not lower than to memSize(). Method memPack() performs a garbage collection to gain free memory resulting from removed names.

Warning: Since the keys the NameSet uses to reference the strings are generated internally, it is extremly important that the calls to DataSet from within NameSet are synchronous to any calls outside to DataSet, such as in row or column adding.

Definition at line 61 of file nameset.h.

Constructor & Destructor Documentation

NameSet	(	int	max = `10000`,
		int	mmax = `-1`,
		Real	fac = `2`,
		Real	memFac = `2`
	)

explicit

default constructor.

Parameters

max	start value for max()
mmax	start value for memMax()
fac	start value for factor
memFac	start value for memFactor

Definition at line 246 of file nameset.cpp.

References NameSet::max(), NameSet::mem, NameSet::memmax, NameSet::memused, and soplex::spx_alloc().

~NameSet ( )

destructor.

Definition at line 258 of file nameset.cpp.

References NameSet::mem, and soplex::spx_free().

NameSet ( const NameSet & old )

private

copy constructor.

Member Function Documentation

void add ( const char * str )

Definition at line 25 of file nameset.cpp.

Referenced by NameSet::add(), soplex::hasRowName(), SPxBasis::readBasis(), soplex::readColName(), soplex::readCols(), SPxLP::readLPF(), and soplex::readRows().

void add	(	DataKey &	key,
		const char *	str
	)

adds name str to NameSet.

Definition at line 31 of file nameset.cpp.

References NameSet::factor, NameSet::hashtab, NameSet::max(), NameSet::mem, NameSet::memFactor, NameSet::memMax(), NameSet::memPack(), NameSet::memRemax(), NameSet::memSize(), NameSet::memused, NameSet::reMax(), and NameSet::size().

void add ( const NameSet & set )

Definition at line 64 of file nameset.cpp.

References NameSet::add(), NameSet::hashtab, and NameSet::num().

void add	(	DataKey	key[],
		const NameSet &	nset
	)

adds all names in set to NameSet.

Definition at line 74 of file nameset.cpp.

References NameSet::add(), NameSet::hashtab, and NameSet::num().

void clear ( )

removes all names from NameSet.

Definition at line 131 of file nameset.cpp.

References NameSet::hashtab, and NameSet::memused.

Referenced by SPxLP::readLPF(), and SPxLP::readMPS().

bool has ( int pnum ) const

does NameSet has a name with number pnum?

Definition at line 231 of file nameset.h.

Referenced by SoPlex::getColName(), soplex::getColName(), SoPlex::getRowName(), soplex::getRowName(), NameSet::isConsistent(), SPxLP::readLPF(), soplex::readRows(), and NameSet::remove().

bool has ( const char * str ) const

does NameSet has a name str?

Definition at line 237 of file nameset.h.

References NameSet::hashtab.

bool has ( const DataKey & pkey ) const

does NameSet has a name with DataKey pkey?

Definition at line 244 of file nameset.h.

bool isConsistent ( ) const

consistency check.

Definition at line 263 of file nameset.cpp.

References NameSet::has(), NameSet::hashtab, NameSet::key(), NameSet::mem, NameSet::memmax, NameSet::memused, MSGinconsistent, and NameSet::num().

Referenced by NameSet::remove().

DataKey key ( int pnum ) const

returns DataKey of the pnum 'th name in NameSet.

Definition at line 198 of file nameset.h.

Referenced by NameSet::isConsistent(), NameSet::memPack(), NameSet::memRemax(), soplex::operator<<(), and NameSet::remove().

DataKey key ( const char * str ) const

returns DataKey of name str in NameSet.

Definition at line 204 of file nameset.h.

References NameSet::hashtab.

int max ( ) const

returns maximum nr. of names that fit into NameSet.

Definition at line 174 of file nameset.h.

Referenced by NameSet::add(), and NameSet::NameSet().

int memMax ( ) const

returns maximum length of string memory.

Definition at line 186 of file nameset.h.

References NameSet::memmax.

Referenced by NameSet::add(), and NameSet::memPack().

void memPack ( )

garbage collection.

Definition at line 155 of file nameset.cpp.

References NameSet::hashtab, NameSet::key(), NameSet::mem, NameSet::memMax(), NameSet::memSize(), NameSet::memused, NameSet::num(), soplex::spx_alloc(), and soplex::spx_free().

Referenced by NameSet::add().

void memRemax ( int newmax = 0 )

resets memMax() to newmax.

Definition at line 144 of file nameset.cpp.

References NameSet::hashtab, NameSet::key(), NameSet::mem, NameSet::memmax, NameSet::memSize(), NameSet::num(), and soplex::spx_realloc().

Referenced by NameSet::add().

int memSize ( ) const

returns used length of string memory.

Definition at line 192 of file nameset.h.

References NameSet::memused.

Referenced by NameSet::add(), NameSet::memPack(), and NameSet::memRemax().

int num ( ) const

returns nr. of names in NameSet.

Definition at line 168 of file nameset.h.

Referenced by NameSet::add(), NameSet::isConsistent(), NameSet::memPack(), NameSet::memRemax(), soplex::operator<<(), and soplex::readColName().

int number ( const DataKey & pkey ) const

returns number of name with DataKey pkey in NameSet.

Definition at line 212 of file nameset.h.

Referenced by NameSet::number(), SPxBasis::readBasis(), soplex::readBounds(), soplex::readColName(), soplex::readCols(), soplex::readRanges(), soplex::readRhs(), and soplex::readRows().

int number ( const char * str ) const

returns number of name str in NameSet.

Definition at line 218 of file nameset.h.

References NameSet::hashtab, and NameSet::number().

NameSet& operator= ( const NameSet & rhs )

private

assignment operator.

const char* operator[] ( int pnum ) const

returns num 'th name of NameSet.

Definition at line 156 of file nameset.h.

References NameSet::mem.

const char* operator[] ( const DataKey & pkey ) const

returns name for DataKey pkey of NameSet.

Definition at line 162 of file nameset.h.

References NameSet::mem.

void reMax ( int newmax = 0 )

resets max() to newmax.

Definition at line 138 of file nameset.cpp.

References NameSet::hashtab.

Referenced by NameSet::add(), and SPxBasis::readBasis().

void remove ( const DataKey & key )

removes name with DataKey key from NameSet.

Definition at line 96 of file nameset.cpp.

References NameSet::has(), NameSet::hashtab, and NameSet::mem.

void remove ( int pnum )

removes pnum 'th name from NameSet.

Definition at line 272 of file nameset.h.

References NameSet::key().

void remove ( const char * str )

removes name str from NameSet.

Definition at line 84 of file nameset.cpp.

References NameSet::hashtab.

void remove	(	const DataKey	keys[],
		int	n
	)

removes n names with DataKeys keys from NameSet.

Definition at line 104 of file nameset.cpp.

void remove	(	const int	nums[],
		int	n
	)

removes n names with numbers nums from NameSet.

Definition at line 110 of file nameset.cpp.

void remove ( int dstat[] )

remove all entries where dstat is less than zero.

Definition at line 116 of file nameset.cpp.

References NameSet::hashtab, NameSet::isConsistent(), and NameSet::mem.

int size ( ) const

returns maximum DataKey::idx used in NameSet.

Definition at line 180 of file nameset.h.

Referenced by NameSet::add().

Member Data Documentation

Real factor

memory extension factor for entries.

When more than max() names are added to a NameSet, it is automatically resized to fit the additional names. Parameter factor is the factor by which the element memory is extended to do so.

Definition at line 317 of file nameset.h.

Referenced by NameSet::add().

DataHashTable< Name, DataKey > hashtab

private

hashtable for names

Every name in a NameSet is assigned a DataKey by which it can be accessed (see NameSet::operator[]()). See DataKey for a more detailed description of the concept of Keys.

Definition at line 147 of file nameset.h.

Referenced by NameSet::add(), NameSet::clear(), NameSet::has(), NameSet::isConsistent(), NameSet::key(), NameSet::memPack(), NameSet::memRemax(), NameSet::number(), NameSet::reMax(), and NameSet::remove().

char* mem

private

string memory

Definition at line 140 of file nameset.h.

Referenced by NameSet::add(), NameSet::isConsistent(), NameSet::memPack(), NameSet::memRemax(), NameSet::NameSet(), NameSet::operator[](), NameSet::remove(), and NameSet::~NameSet().

Real memFactor

memory extension factor for names.

When the names added to a NameSet do no longer fit into the name memory (i.e. the memory for saving the strings), it is automatically resized to fit the additional names. Parameter memFactor is the factor by which this memory is extended to do so.

Definition at line 325 of file nameset.h.

Referenced by NameSet::add().

int memmax

private

size of string memory

Definition at line 141 of file nameset.h.

Referenced by NameSet::isConsistent(), NameSet::memMax(), NameSet::memRemax(), and NameSet::NameSet().

int memused

private

size of used string memory

Definition at line 142 of file nameset.h.

Referenced by NameSet::add(), NameSet::clear(), NameSet::isConsistent(), NameSet::memPack(), NameSet::memSize(), and NameSet::NameSet().

DataSet< int > set

private

name set.

Definition at line 139 of file nameset.h.

Classes

Public Member Functions

Public Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation