diff options
Diffstat (limited to 'doc/man/man3/qptrstack.3qt')
-rw-r--r-- | doc/man/man3/qptrstack.3qt | 164 |
1 files changed, 0 insertions, 164 deletions
diff --git a/doc/man/man3/qptrstack.3qt b/doc/man/man3/qptrstack.3qt deleted file mode 100644 index 5632af1d9..000000000 --- a/doc/man/man3/qptrstack.3qt +++ /dev/null @@ -1,164 +0,0 @@ -'\" t -.TH QPtrStack 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- -.\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the -.\" license file included in the distribution for a complete license -.\" statement. -.\" -.ad l -.nh -.SH NAME -QPtrStack \- Template class that provides a stack -.SH SYNOPSIS -\fC#include <ntqptrstack.h>\fR -.PP -.SS "Public Members" -.in +1c -.ti -1c -.BI "\fBQPtrStack\fR ()" -.br -.ti -1c -.BI "\fBQPtrStack\fR ( const QPtrStack<type> & s )" -.br -.ti -1c -.BI "\fB~QPtrStack\fR ()" -.br -.ti -1c -.BI "QPtrStack<type> & \fBoperator=\fR ( const QPtrStack<type> & s )" -.br -.ti -1c -.BI "bool \fBautoDelete\fR () const" -.br -.ti -1c -.BI "void \fBsetAutoDelete\fR ( bool enable )" -.br -.ti -1c -.BI "uint \fBcount\fR () const" -.br -.ti -1c -.BI "bool \fBisEmpty\fR () const" -.br -.ti -1c -.BI "void \fBpush\fR ( const type * d )" -.br -.ti -1c -.BI "type * \fBpop\fR ()" -.br -.ti -1c -.BI "bool \fBremove\fR ()" -.br -.ti -1c -.BI "void \fBclear\fR ()" -.br -.ti -1c -.BI "type * \fBtop\fR () const" -.br -.ti -1c -.BI "\fBoperator type *\fR () const" -.br -.ti -1c -.BI "type * \fBcurrent\fR () const" -.br -.in -1c -.SS "Protected Members" -.in +1c -.ti -1c -.BI "virtual QDataStream & \fBread\fR ( QDataStream & s, QPtrCollection::Item & item )" -.br -.ti -1c -.BI "virtual QDataStream & \fBwrite\fR ( QDataStream & s, QPtrCollection::Item item ) const" -.br -.in -1c -.SH DESCRIPTION -The QPtrStack class is a template class that provides a stack. -.PP -QValueStack is an STL-compatible alternative to this class. -.PP -Define a template instance QPtrStack<X> to create a stack that operates on pointers to X, (X*). -.PP -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(). Use top() to get a reference to the top element without changing the stack. -.PP -You can control the stack's deletion policy with setAutoDelete(). -.PP -For compatibility with the QPtrCollection classes current() and remove() are provided; they both operate on the top(). -.PP -See also QPtrList, QPtrQueue, and Non-GUI Classes. -.SH MEMBER FUNCTION DOCUMENTATION -.SH "QPtrStack::QPtrStack ()" -Creates an empty stack. -.SH "QPtrStack::QPtrStack ( const QPtrStack<type> & s )" -Creates a stack by making a shallow copy of another stack \fIs\fR. -.SH "QPtrStack::~QPtrStack ()" -Destroys the stack. All items will be deleted if autoDelete() is TRUE. -.SH "bool QPtrStack::autoDelete () const" -The same as QPtrCollection::autoDelete(). -.PP -See also setAutoDelete(). -.SH "void QPtrStack::clear ()" -Removes all items from the stack, deleting them if autoDelete() is TRUE. -.PP -See also remove(). -.SH "uint QPtrStack::count () const" -Returns the number of items in the stack. -.PP -See also isEmpty(). -.SH "type * QPtrStack::current () const" -Returns a pointer to the top item on the stack (most recently pushed). The stack is not changed. Returns 0 if the stack is empty. -.SH "bool QPtrStack::isEmpty () const" -Returns TRUE if the stack contains no elements; otherwise returns FALSE. -.SH "QPtrStack::operator type * () const" -Returns a pointer to the top item on the stack (most recently pushed). The stack is not changed. Returns 0 if the stack is empty. -.SH "QPtrStack<type> & QPtrStack::operator= ( const QPtrStack<type> & s )" -Sets the contents of this stack by making a shallow copy of another stack \fIs\fR. Elements currently in this stack will be deleted if autoDelete() is TRUE. -.SH "type * QPtrStack::pop ()" -Removes the top item from the stack and returns it. The stack must not be empty. -.SH "void QPtrStack::push ( const type * d )" -Adds an element \fId\fR to the top of the stack. Last in, first out. -.SH "QDataStream & QPtrStack::read ( QDataStream & s, QPtrCollection::Item & item )\fC [virtual protected]\fR" -Reads a stack item, \fIitem\fR, from the stream \fIs\fR and returns a reference to the stream. -.PP -The default implementation sets \fIitem\fR to 0. -.PP -See also write(). -.SH "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; otherwise returns FALSE. -.PP -See also clear(). -.SH "void QPtrStack::setAutoDelete ( bool enable )" -Defines whether this stack auto-deletes its contents. The same as QPtrCollection::setAutoDelete(). -.PP -If \fIenable\fR is TRUE the stack auto-deletes its contents; if \fIenable\fR is FALSE the stack does not delete its contents. -.PP -See also autoDelete(). -.SH "type * QPtrStack::top () const" -Returns a pointer to the top item on the stack (most recently pushed). The stack is not changed. Returns 0 if the stack is empty. -.SH "QDataStream & QPtrStack::write ( QDataStream & s, QPtrCollection::Item item ) const\fC [virtual protected]\fR" -Writes a stack item, \fIitem\fR, to the stream \fIs\fR and returns a reference to the stream. -.PP -The default implementation does nothing. -.PP -See also read(). - -.SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqptrstack.html -.BR http://www.trolltech.com/faq/tech.html -.SH COPYRIGHT -Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the -license file included in the distribution for a complete license -statement. -.SH AUTHOR -Generated automatically from the source code. -.SH BUGS -If you find a bug in Qt, please report it as described in -.BR http://doc.trolltech.com/bughowto.html . -Good bug reports help us to help you. Thank you. -.P -The definitive Qt documentation is provided in HTML format; it is -located at $QTDIR/doc/html and can be read using Qt Assistant or with -a web browser. This man page is provided as a convenience for those -users who prefer man pages, although this format is not officially -supported by Trolltech. -.P -If you find errors in this manual page, please report them to -.BR qt-bugs@trolltech.com . -Please include the name of the manual page (qptrstack.3qt) and the Qt -version (3.3.8). |