QPtrStack(3qt)

📦 version 3.3.8b, in fedora 43, fedora 44

💖 QPtrStack(3qt) — bestie edition 💖

okay so welcome to the QPtrStack(3qt) manual page, and babes, we are about to get so organized. this is from the Qt 3 era, it's giving vintage, it's giving legendary, and it's honestly so much simpler than it looks. grab a strawberry 🍓 and let's go.

✨ NAME ✨

QPtrStack — a template class that provides a stack 💅

🌈 SYNOPSIS 🌈

#include <qptrstack.h>

👑 Public Members

QPtrStack ()
QPtrStack ( const QPtrStack<type> & s )
~QPtrStack ()
QPtrStack<type> & operator= ( const QPtrStack<type> & s )
bool autoDelete () const
void setAutoDelete ( bool enable )
uint count () const
bool isEmpty () const
void push ( const type * d )
type * pop ()
bool remove ()
void clear ()
type * top () const
operator type * () const
type * current () const

🧚 Protected Members

virtual QDataStream & read ( QDataStream & s, QPtrCollection::Item &
    item )
virtual QDataStream & write ( QDataStream & s, QPtrCollection::Item item
    ) const

🦋 DESCRIPTION 🦋

so the QPtrStack class is a template class that provides a stack. that's the whole vibe. 🌸

QValueStack is an STL-compatible alternative to this class — just so you know your options, bestie.

you define a template instance QPtrStack<X> to create a stack that operates on pointers to X, (X*).

a stack is a last in, first out (LIFO) structure. think of it like a stack of pancakes 🥞 — the last one you put on top is the first one you grab. items get 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 — like peeking, not touching. 👀

you can control the stack's deletion policy with setAutoDelete().

for compatibility with the QPtrCollection classes, current() and remove() are provided; they both operate on the top().

See also QPtrList, QPtrQueue, and Non-GUI Classes.

💜 MEMBER FUNCTION DOCUMENTATION 💜

QPtrStack::QPtrStack ()

creates an empty stack. blank slate, main character energy, nothing in it yet. ✨

QPtrStack::QPtrStack ( const QPtrStack<type> & s )

creates a stack by making a shallow copy of another stack s. (shallow, not deep — we're copying the pointers, not duplicating the whole world. no cap.)

QPtrStack::~QPtrStack ()

destroys the stack. all items will be deleted if autoDelete() is TRUE. 😭 so like, know your settings before you let this one go.

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. poof. gone. 🫶

See also remove().

uint QPtrStack::count () const

returns the number of items in the stack. the headcount, the census, the "how many besties are in the group chat" number. 💀

See also isEmpty().

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.

bool QPtrStack::isEmpty () const

returns TRUE if the stack contains no elements; otherwise returns FALSE. vibe check: is it empty or not. 🕵️‍♀️

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. (yes, same energy as top() and current() — it's a whole family. 🎀)

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. ⚠️ so like, that's destructive, be aware.

type * QPtrStack::pop ()

removes the top item from the stack and returns it. 🔥

the stack must not be empty. fr fr, don't do that.

void QPtrStack::push ( const type * d )

adds an element d to the top of the stack. last in, first out. iconic behavior honestly. 👑

QDataStream & QPtrStack::read ( QDataStream & s, QPtrCollection::Item & item )

[virtual protected]

reads a stack item, 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; otherwise returns FALSE.

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; if enable is FALSE the stack does not delete its contents.

See also autoDelete().

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.

QDataStream & QPtrStack::write ( QDataStream & s, QPtrCollection::Item item ) const

[virtual protected]

writes a stack item, item, to the stream s and returns a reference to the stream.

the default implementation does nothing.

See also read().

🌟 SEE ALSO 🌟

Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the license file included in the distribution for a complete license statement.

💜 AUTHOR 💜

Generated automatically from the source code. (yes, the author is literally a machine. slay, i guess. 🤖✨)

🙈 BUGS 🙈

if you find a bug in Qt, please report it as described in http://doc.trolltech.com/bughowto.html. good bug reports help us to help you. thank you. 🫶

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.

if you find errors in this manual page, please report them to qt-bugs@trolltech.com. please include the name of the manual page (qptrstack.3qt) and the Qt version (3.3.8). 💖

okay bestie that's the whole page, you ate that. this came to you from Trolltech AS, dated 2 February 2007, from the Qt 3.3.8 era — like, ancient history but still lowkey iconic. now go push something. 💅🌈💜

📦 where this page comes from