QPtrStack Class Reference
The QPtrStack class is a template class that provides a stack.
More...
#include <qptrstack.h>
List of all member functions.
Public Members
QPtrStack<type> &
operator= ( const QPtrStack<type> & s )
void
push ( const type * d )
Protected Members
virtual QDataStream &
read ( QDataStream & s, QPtrCollection::Item & item )
virtual QDataStream &
write ( QDataStream & s, QPtrCollection::Item item ) const
Detailed Description
The QPtrStack class is a template class that provides a stack.
Define a template instance QPtrStack<X> to create a stack that
operates on pointers to X, or X*, for example a stack to store
QListViewItems:
QPtrStack<QListViewItem> stack;
A stack is a last in, first out (LIFO) structure. Items are added to
the top of the stack with push() and retrieved from the top
with pop(), e.g.:
QListViewItem * element;
element = new QListViewItem( stack.top(), qName, namespaceURI );
stack.push( element );
(cf. xml/tagreader-with-features/structureparser.cpp)
See also QPtrList, QPtrQueue and Collection Classes.
Member Function Documentation
QPtrStack::QPtrStack ()
Creates an empty stack.
QPtrStack::QPtrStack ( const QPtrStack<type> & s )
Creates a stack by making a shallow copy of another stack s.
QPtrStack::~QPtrStack ()
Destroys the stack. All items will be deleted if autoDelete() is TRUE.
bool QPtrStack::autoDelete () const
The same as QPtrCollection::autoDelete().
See also setAutoDelete().
void QPtrStack::clear ()
Removes all items from the stack, deleting them if
autoDelete() is TRUE.
See also remove().
uint QPtrStack::count () const
Returns the number of items in the stack.
See also isEmpty().
type * QPtrStack::current () const
Returns a reference to the top item on the stack (most recently pushed).
The stack is not changed.
bool QPtrStack::isEmpty () const
Returns TRUE is the stack contains no elements to be popped.
QPtrStack::operator type * () const
Returns a reference to the top item on the stack (most recently pushed).
The stack is not changed.
QPtrStack<type> & QPtrStack::operator= ( const QPtrStack<type> & s )
Sets the contents of this stack by making a shallow copy of another stack s.
Elements currently in this stack will be deleted if autoDelete() is TRUE.
type * QPtrStack::pop ()
Removes the top item from the stack and returns it.
void QPtrStack::push ( const type * d )
Adds an element d to the top of the stack. Last in, first out.
Reads a stack item from the stream s and returns a reference to
the stream.
The default implementation sets item to 0.
See also write().
bool QPtrStack::remove ()
Removes the top item from the stack and deletes it if
autoDelete() is TRUE. Returns TRUE if there was an item to pop.
See also clear().
void QPtrStack::setAutoDelete ( bool enable )
Defines whether this stack auto-deletes its contents.
The same as QPtrCollection::setAutoDelete().
If enable is TRUE the stack auto-deletes its contents
whereas it never deletes them if enable is
FALSE.
See also autoDelete().
type * QPtrStack::top () const
Returns a reference to the top item on the stack (most recently pushed).
The stack is not changed.
Writes a stack item to the stream s and returns a reference to the
stream.
The default implementation does nothing.
See also read().
Search the documentation, FAQ, qt-interest archive and more (uses
www.trolltech.com):
This file is part of the Qt toolkit,
copyright © 1995-2001
Trolltech, all rights reserved.
Copyright © 2001 Trolltech | Trademarks
| Qt version 3.0.0-beta1-beta1
|