RWSlistCollectablesStack Class Reference

A restricted interface to class RWSlistCollectables to implement a last in first out (LIFO) stack. More...

#include <rw/stackcol.h>

Inheritance diagram for RWSlistCollectablesStack:

Public Member Functions
	RWSlistCollectablesStack ()
	RWSlistCollectablesStack (const RWSlistCollectablesStack &stk)
	RWSlistCollectablesStack (RWCollectable *a)
	RWSlistCollectablesStack (RWSlistCollectablesStack &&stk)
virtual RWCollectable *	copy () const
virtual RWCollectable *	insert (RWCollectable *a)
virtual RWClassID	isA () const
virtual bool	isEqual (const RWCollectable *) const
virtual RWCollectable *	newSpecies () const
RWSlistCollectablesStack &	operator= (const RWSlistCollectablesStack &rhs)
RWSlistCollectablesStack &	operator= (RWSlistCollectablesStack &&rhs)
RWCollectable *	pop ()
void	push (RWCollectable *a)
virtual RWCollectable *	remove (const RWCollectable *)
virtual void	restoreGuts (RWFile &)
virtual void	restoreGuts (RWvistream &)
RWCollectable *	top () const
Public Member Functions inherited from RWSlistCollectables
	RWSlistCollectables ()
	RWSlistCollectables (const RWSlistCollectables &lst)
	RWSlistCollectables (RWCollectable *a)
	RWSlistCollectables (RWSlistCollectables &&lst)
virtual void	apply (RWapplyCollectable ap, void *x)
virtual RWCollectable *&	at (size_t i)
virtual const RWCollectable *	at (size_t i) const
virtual void	clear ()
virtual bool	contains (const RWCollectable *target) const
bool	containsReference (const RWCollectable *e) const
virtual size_t	entries () const
virtual RWCollectable *	find (const RWCollectable *target) const
RWCollectable *	findReference (const RWCollectable *e) const
virtual RWCollectable *	first () const
RWCollectable *	get ()
virtual size_t	index (const RWCollectable *c) const
virtual RWCollectable *	insertAt (size_t indx, RWCollectable *e)
virtual bool	isEmpty () const
virtual RWCollectable *	last () const
virtual RWConstIterator *	newConstIterator () const
virtual RWIterator *	newIterator ()
virtual size_t	occurrencesOf (const RWCollectable *target) const
size_t	occurrencesOfReference (const RWCollectable *e) const
RWSlistCollectables &	operator= (const RWSlistCollectables &rhs)
RWSlistCollectables &	operator= (RWSlistCollectables &&rhs)
bool	operator== (const RWSlistCollectables &s) const
virtual RWCollectable *	prepend (RWCollectable *a)
RWCollectable *	removeReference (const RWCollectable *e)
Public Member Functions inherited from RWCollection
virtual	~RWCollection ()
RWBag	asBag () const
RWBinaryTree	asBinaryTree () const
RWOrdered	asOrderedCollection () const
RWSet	asSet () const
RWBinaryTree	asSortedCollection () const
virtual RWspace	binaryStoreSize () const
virtual void	clearAndDestroy ()
void	operator+= (const RWCollection &c)
void	operator-= (const RWCollection &c)
virtual void	saveGuts (RWFile &) const
virtual void	saveGuts (RWvostream &) const
RWCollection *	select (RWtestCollectable tst, void *vp) const
Public Member Functions inherited from RWCollectable
virtual	~RWCollectable ()
virtual int	compareTo (const RWCollectable *) const
virtual unsigned	hash () const
RWspace	recursiveStoreSize () const
RWStringID	stringID () const

Private Member Functions
virtual RWCollectable *	append (RWCollectable *)
virtual void	removeAndDestroy (const RWCollectable *)

Additional Inherited Members
Static Public Member Functions inherited from RWCollectable
static RWClassID	classID (const RWStringID &name)
static RWClassID	classIsA ()
static bool	isAtom (RWClassID id)
static RWspace	nilStoreSize ()
Static Public Attributes inherited from RWCollection
static size_t	DEFAULT_CAPACITY
Related Symbols inherited from RWCollection
typedef void(*	RWapplyCollectable) (RWCollectable *, void *)
typedef bool(*	RWtestCollectable) (const RWCollectable *, const void *)
typedef bool(*	RWtestCollectablePair) (const RWCollectable *, const RWCollectable *, const void *)

Detailed Description

Class RWSlistCollectablesStack represents a restricted interface to class RWSlistCollectables to implement a last in first out (LIFO) stack. A stack is a sequential list for which all insertions and deletions are made at one end (the beginning of the list). Hence, the ordering is determined externally by the ordering of the insertions. Duplicates are allowed.

An object stored by RWSlistCollectablesStack must inherit from abstract base class RWCollectable. You must use the virtual function isEqual() (see class RWCollectable) to find a match between a target and an item in the stack.

This class corresponds to the Smalltalk class Stack.

Synopsis

// Smalltalk typedef:
typedef RWSlistCollectablesStack Stack;
#include <rw/stackcol.h>
RWSlistCollectablesStack a;

Persistence

Polymorphic

Constructor & Destructor Documentation

RWSlistCollectablesStack() [1/4]

RWSlistCollectablesStack::RWSlistCollectablesStack

(

)

Constructs an empty stack.

RWSlistCollectablesStack() [2/4]

RWSlistCollectablesStack::RWSlistCollectablesStack ( RWCollectable * a )

inline

Constructs a stack with one entry a.

RWSlistCollectablesStack() [3/4]

RWSlistCollectablesStack::RWSlistCollectablesStack ( const RWSlistCollectablesStack & stk )

inline

Makes a shallow copy of stk.

RWSlistCollectablesStack() [4/4]

RWSlistCollectablesStack::RWSlistCollectablesStack ( RWSlistCollectablesStack && stk )

inline

Move constructor. The constructed RWSlistCollectablesStack takes ownership of the data owned by stk.

Condition:

This method is available only on platforms with rvalue reference support.

Member Function Documentation

append()

virtual RWCollectable * RWSlistCollectablesStack::append ( RWCollectable * a )

inlineprivatevirtual

Adds a to the end of the collection and returns it. Returns rwnil if the insertion was unsuccessful.

Reimplemented from RWSlistCollectables.

copy()

virtual RWCollectable * RWSlistCollectablesStack::copy ( ) const

virtual

Returns a new, copy-constructed object of the same type as self. The caller is responsible for deleting the object.

Reimplemented from RWSlistCollectables.

insert()

virtual RWCollectable * RWSlistCollectablesStack::insert ( RWCollectable * a )

inlinevirtual

Same as push().

Reimplemented from RWSlistCollectables.

isA()

virtual RWClassID RWSlistCollectablesStack::isA ( ) const

virtual

Returns __RWSLISTCOLLECTABLESSTACK, i.e. a class identifier, that identifies this object's class.

Reimplemented from RWSlistCollectables.

isEqual()

virtual bool RWSlistCollectablesStack::isEqual ( const RWCollectable * t ) const

virtual

Behaves as if compareTo(t) was invoked, returning true if the result equals 0, false otherwise.

Reimplemented from RWSlistCollectables.

newSpecies()

virtual RWCollectable * RWSlistCollectablesStack::newSpecies ( ) const

virtual

Returns a new, default-constructed object of the same type as self. The caller is responsible for deleting the object.

Reimplemented from RWSlistCollectables.

operator=() [1/2]

RWSlistCollectablesStack & RWSlistCollectablesStack::operator= ( const RWSlistCollectablesStack & rhs )

inline

Assignment operator. Makes a shallow copy of rhs.

operator=() [2/2]

RWSlistCollectablesStack & RWSlistCollectablesStack::operator= ( RWSlistCollectablesStack && rhs )

inline

Move assignment. Self takes ownership of the data owned by rhs.

Condition:

This method is available only on platforms with rvalue reference support.

pop()

RWCollectable * RWSlistCollectablesStack::pop ( )

inline

Removes and returns the item at the top of the stack, or returns rwnil if the stack is empty.

push()

void RWSlistCollectablesStack::push ( RWCollectable * a )

inline

Adds an item to the top of the stack.

remove()

virtual RWCollectable * RWSlistCollectablesStack::remove ( const RWCollectable * )

inlinevirtual

Calls pop(). The argument is ignored.

Reimplemented from RWSlistCollectables.

removeAndDestroy()

virtual void RWSlistCollectablesStack::removeAndDestroy ( const RWCollectable * target )

inlineprivatevirtual

Removes and deletes the first item in the collection which "matches" the object pointed to by target.

Reimplemented from RWCollection.

restoreGuts() [1/2]

virtual void RWSlistCollectablesStack::restoreGuts ( RWFile & )

virtual

Repeatedly calls the global operator:

RWFile& operator>>(RWFile&, RWCollectable*&);

followed by insert(RWCollectable*) for each item in the collection.

Reimplemented from RWCollection.

restoreGuts() [2/2]

virtual void RWSlistCollectablesStack::restoreGuts ( RWvistream & )

virtual

Repeatedly calls the global operator:

RWvistream& operator>>(RWvistream&, RWCollectable*&);

followed by insert(RWCollectable*) for each item in the collection.

Reimplemented from RWCollection.

top()

RWCollectable * RWSlistCollectablesStack::top ( ) const

inline

Returns the item at the top of the stack or returns nil if the stack is empty.