PTLib  Version 2.10.10
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
PStringToOrdinal Class Reference

This is a dictionary collection class of ordinals keyed by PString objects. More...

#include <pstring.h>

Inheritance diagram for PStringToOrdinal:
POrdinalDictionary< K > PAbstractDictionary PHashTable PCollection PContainer PObject

Classes

struct  Initialiser
 Structure for static array initialiser for class. More...

Public Member Functions

Construction
 PStringToOrdinal (PINDEX count, const Initialiser *init, PBoolean caseless=false)
 Initialise the string dictionary of ordinals from the static array.
Overrides from class PObject
virtual void ReadFrom (istream &strm)
 Input the contents of the object from the stream.
- Public Member Functions inherited from POrdinalDictionary< K >
 POrdinalDictionary ()
 Create a new, empty, dictionary.
virtual PObjectClone () const
 Make a complete duplicate of the dictionary.
PINDEX operator[] (const K &key) const
 Get the object contained in the dictionary at the key position.
PBoolean Contains (const K &key) const
 Determine if the value of the object is contained in the hash table.
virtual POrdinalKeyGetAt (const K &key) const
virtual PBoolean SetDataAt (PINDEX index, PINDEX ordinal)
 Set the data at the specified ordinal index position in the dictionary.
virtual PBoolean SetAt (const K &key, PINDEX ordinal)
 Add a new object to the collection.
virtual PINDEX RemoveAt (const K &key)
 Remove an object at the specified key.
const K & GetKeyAt (PINDEX index) const
 Get the key in the dictionary at the ordinal index position.
PINDEX GetDataAt (PINDEX index) const
 Get the data in the dictionary at the ordinal index position.
- Public Member Functions inherited from PAbstractDictionary
PINLINE PAbstractDictionary ()
 Create a new, empty, dictionary.
virtual void PrintOn (ostream &strm) const
 Output the contents of the object to the stream.
virtual PINDEX Insert (const PObject &key, PObject *obj)
 Insert a new object into the dictionary.
virtual PINDEX InsertAt (PINDEX index, PObject *obj)
 Insert a new object at the specified index.
virtual PObjectRemoveAt (PINDEX index)
 Remove an object at the specified index.
virtual PBoolean SetAt (PINDEX index, PObject *val)
 Set the object at the specified index to the new value.
virtual PObjectGetAt (PINDEX index) const
 Get the object at the specified index position.
virtual PINDEX GetObjectsIndex (const PObject *obj) const
 Search the collection for the specific instance of the object.
virtual PINDEX GetValuesIndex (const PObject &obj) const
 Search the collection for the specified value of the object.
virtual PBoolean SetDataAt (PINDEX index, PObject *obj)
 Set the data at the specified ordinal index position in the dictionary.
virtual PBoolean AbstractSetAt (const PObject &key, PObject *obj)
 Add a new object to the collection.
virtual PObjectGetRefAt (const PObject &key) const
 Get the object at the specified key position.
virtual PObjectAbstractGetAt (const PObject &key) const
 Get the object at the specified key position.
virtual void AbstractGetKeys (PArrayObjects &keys) const
 Get an array containing all the keys for the dictionary.
- Public Member Functions inherited from PHashTable
 PHashTable ()
 Create a new, empty, hash table.
virtual Comparison Compare (const PObject &obj) const
 Get the relative rank of the two hash tables.
virtual PBoolean SetSize (PINDEX newSize)
 This function is meaningless for hash table.
PINLINE PBoolean AbstractContains (const PObject &key) const
 Determine if the value of the object is contained in the hash table.
virtual const PObjectAbstractGetKeyAt (PINDEX index) const
 Get the key in the hash table at the ordinal index position.
virtual PObjectAbstractGetDataAt (PINDEX index) const
 Get the data in the hash table at the ordinal index position.
- Public Member Functions inherited from PCollection
 PCollection (PINDEX initialSize=0)
 Create a new collection.
virtual PINDEX Append (PObject *obj)=0
 Append a new object to the collection.
virtual PBoolean Remove (const PObject *obj)=0
 Remove the object from the collection.
virtual void RemoveAll ()
 Remove all of the elements in the collection.
PINLINE void AllowDeleteObjects (PBoolean yes=true)
 Allow or disallow the deletion of the objects contained in the collection.
void DisallowDeleteObjects ()
 Disallow the deletion of the objects contained in the collection.
- Public Member Functions inherited from PContainer
 PContainer (PINDEX initialSize=0)
 Create a new unique container.
 PContainer (const PContainer &cont)
 Create a new refernce to container.
PContaineroperator= (const PContainer &cont)
 Assign one container reference to another.
virtual ~PContainer ()
 Destroy the container class.
virtual PINDEX GetSize () const
 Get the current size of the container.
PBoolean SetMinSize (PINDEX minSize)
 Set the minimum size of container.
virtual PBoolean IsEmpty () const
 Determine if the container is empty.
PBoolean IsUnique () const
 Determine if container is unique reference.
virtual PBoolean MakeUnique ()
 Make this instance to be the one and only reference to the container contents.
- Public Member Functions inherited from PObject
virtual ~PObject ()
virtual PINDEX HashFunction () const
 This function yields a hash value required by the PDictionary class.
virtual const char * GetClass (unsigned ancestor=0) const
 Get the current dynamic type of the object instance.
PBoolean IsClass (const char *cls) const
virtual PBoolean InternalIsDescendant (const char *clsName) const
 Determine if the dynamic type of the current instance is a descendent of the specified class.
virtual Comparison CompareObjectMemoryDirect (const PObject &obj) const
 Determine the byte wise comparison of two objects.
bool operator== (const PObject &obj) const
 Compare the two objects.
bool operator!= (const PObject &obj) const
 Compare the two objects.
bool operator< (const PObject &obj) const
 Compare the two objects.
bool operator> (const PObject &obj) const
 Compare the two objects.
bool operator<= (const PObject &obj) const
 Compare the two objects.
bool operator>= (const PObject &obj) const
 Compare the two objects.

Additional Inherited Members

- Public Types inherited from PHashTable
typedef PHashTableElement Element
typedef PHashTableInfo Table
- Static Public Member Functions inherited from PObject
static const char * Class ()
 Get the name of the class as a C string.
static Comparison InternalCompareObjectMemoryDirect (const PObject *obj1, const PObject *obj2, PINDEX size)
 Internal function caled from CompareObjectMemoryDirect()
- Public Attributes inherited from PHashTable
PHashTableInfo * hashTable
- Protected Member Functions inherited from POrdinalDictionary< K >
 POrdinalDictionary (int dummy, const POrdinalDictionary *c)
- Protected Attributes inherited from PContainer
PContainerReferencereference
- Friends inherited from PObject

Detailed Description

This is a dictionary collection class of ordinals keyed by PString objects.

It has all the usual functions for a collection, with the object types set to POrdinalKey pointers.

In addition some addition functions are added that take a const POrdinalKey reference or a simple PINDEX instead of a pointer as most standard collection functions do. This is more convenient for when integer expressions are used as parameters to function in the collection.

See the PAbstractDicionary and POrdinalDictionary classes for more information.

Constructor & Destructor Documentation

PStringToOrdinal::PStringToOrdinal ( PINDEX  count,
const Initialiser init,
PBoolean  caseless = false 
)

Initialise the string dictionary of ordinals from the static array.

Parameters
countCount of strings in initialiser array
initArray of Initialiser structures
caselessNew keys are to be PCaselessStrings

Member Function Documentation

virtual void PStringToOrdinal::ReadFrom ( istream &  strm)
virtual

Input the contents of the object from the stream.

This is primarily used by the standard operator>> function.

The default behaviour reads '\n' separated strings until !strm.good().

Reimplemented from PObject.


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