ost::stackpager(3)

NAME

ost::StackPager - The StackPager provides a repository to stash and retrieve working data in last-in-first-out order.

SYNOPSIS

#include <misc.h>
Inherits ost::MemPager.
Public Member Functions
StackPager (size_t pagesize)
    Create a lifo pager as a mempager.
void * push (const void *object, size_t size)
    Push an arbitrary object onto the stack.
void * push (const char *string)
    Push a string onto the stack.
void * pull (void)
    Retrieve next object from stack.
void purge (void)
    Purge the stack of all objects and memory allocations.
Classes
struct frame

Detailed Description

The StackPager provides a repository to stash and retrieve working data in last-in-first-out order.

The use of a mempager to support it's operation allows storage of
arbitrary sized objects with no fixed limit.

Author:

David Sugar <dyfet@ostel.com> last in first out object pager.

Constructor & Destructor Documentation

ost::StackPager::StackPager (size_t pagesize)

Create a lifo pager as a mempager.

Parameters:

pagesize for memory allocation

Member Function Documentation

void* ost::StackPager::push (const void * object, size_t size)

Push an arbitrary object onto the stack.

Returns:

stack memory location.

Parameters:

object pointer to data
size of data.

void* ost::StackPager::push (const char * string)

Push a string onto the stack.

Returns:

stack memory location.

Parameters:

string pointer.

void* ost::StackPager::pull (void)

Retrieve next object from stack.

Returns:

object.

void ost::StackPager::purge (void)

Purge the stack of all objects and memory allocations.

Reimplemented from ost::MemPager.

Author

Generated automatically by Doxygen for GNU CommonC++ from the source
code.

GNU CommonC++ 25 Aug 2008 ost::StackPager(3)