name: ContextPool

synopsis:


g++ [flags ...] file ... -l /isip/tools/lib/$ISIP_BINARY/lib_search.a

#include <ContextPool.h>

long length() const;
Context* get(const Context& obj);
Context* foldAndAllocate(const Context* obj);
Context* extendAndAllocate(const Context* obj, GraphVertex<SearchNode>* ver);
Context* initAndAllocate();
Context* shiftAndAllocate(const Context* obj, GraphVertex<SearchNode>* ver);
Context* setCentralAndAllocate(const Context* obj, GraphVertex<SearchNode>* ver);
Context* setLastAndAllocate(const Context* obj, GraphVertex<SearchNode>* ver);

quick start:


Context some_context;
ContextPool context_pool;
GraphVertex<SearchNode> v;

Context* c1 = context_pool.get(some_context);
Context* c2 = context_pool.assignAndAdvance(c1, &v);

description:

This class caches all context variants generated during the search process and returns a unique reference to the context, which is used for quick constant-time comparisons.

dependencies:

public constants:

define public constants:

static const String CLASS_NAME;

static const String DEF_PARAM;

static const long DEF_CAPACITY = 20000;

error codes:

error codes indicating general errors:

protected data:

define the context pool:

HashTable<Context, Context> pool_d;

declare the debugging parameters:
```
static Integral::DEBUG debug_level_d;
```
declare the memory manager:
```
static MemoryManager mgr_d;
```

required public methods:

static methods:
```
static const String& name();
```

debug methods:

static boolean diagnose(Integral::DEBUG debug_level);

boolean debug(const unichar* message) const;

static boolean setDebug(Integral::DEBUG debug_level);

destructor/constructor(s):

~ContextPool();

ContextPool();

ContextPool(const ContextPool& copy_node);

assign methods:

boolean assign(const ContextPool& copy_node);

operator= method:
```
not present.
```

i/o methods:

long sofSize() const;

boolean read(Sof& sof, long tag, const String& cname = CLASS_NAME);

boolean write(Sof& sof, long tag, const String& cname = CLASS_NAME) const;

boolean readData(Sof& sof, const String& pname = DEF_PARAM, long size = SofParser::FULL_OBJECT, boolean param = true, boolean nested = false);

boolean writeData(Sof& sof, const String& pname = DEF_PARAM) const;

equality methods:

boolean eq(const ContextPool& compare_node) const;

memory management methods:

static void* operator new(size_t size);

static void* operator new[](size_t size);

static void operator delete(void* ptr);

static void operator delete[](void* ptr);

static boolean setGrowSize(long grow_size);

boolean clear(Integral::CMODE ctype = Integral::DEF_CMODE);

class-specific public methods:

declare class specific methods:

long length() const;

Context* get(const Context& obj);

Context* foldAndAllocate(const Context* obj);

Context* extendAndAllocate(const Context* obj, GraphVertex<SearchNode>* ver);

Context* initAndAllocate();

Context* shiftAndAllocate(const Context* obj, GraphVertex<SearchNode>* ver);

Context* setCentralAndAllocate(const Context* obj, GraphVertex<SearchNode>* ver);

Context* setLastAndAllocate(const Context* obj, GraphVertex<SearchNode>* ver);

private methods:

none.

examples:

none.

notes:

none.