A template double linked list of pointers. More...

#include <KviPointerList.h>

Public Member Functions
void	append (const T *d)
	Appends an item at the end of the list. More...

void	append (KviPointerList< T > *l)
	Appends all the items from the list l to this list. More...

T *	at (int idx)
	Returns the item at index position. More...

bool	autoDelete ()
	Returns the autodelete flag. More...

void	clear ()
	Removes all the items from the list. More...

void	copyFrom (KviPointerList< T > *l)
	Clears the list and inserts all the items from the list l. More...

unsigned int	count () const
	Returns the count of the items in the list. More...

T *	current ()
	Returns the current iteration item. More...

int	findRef (const T *d)
	Returns the position of an item. More...

T *	first ()
	Returns the first item in the list. More...

void	insert (int iIndex, const T *d)
	Inserts the item d at the position specified by iIndex. More...

void	insertAfter (const T ref, const T d)
	Inserts the item d after the item ref. More...

void	insertBefore (const T ref, const T d)
	Inserts the item d before the item ref. More...

void	inSort (T *t)
	Inserts the item respecting the sorting order inside the list. More...

void	invert ()
	Inverts the elements in the list. More...

bool	isEmpty () const
	Returns true if the list is empty. More...

KviPointerListIterator< T >	iteratorAt (int idx)
	Returns an iterator pointing to the item at the specified index. More...

KviPointerListIterator< T >	iteratorAtCurrent ()
	Returns an iterator pointing to the current item in the list. More...

KviPointerListIterator< T >	iteratorAtFirst ()
	Returns an iterator pointing to the first item of the list. More...

KviPointerListIterator< T >	iteratorAtLast ()
	Returns an iterator pointing to the first item of the list. More...

KviPointerListIterator< T >	iteratorAtRef (const T *d)
	Returns an iterator pointing to the item with pointer d. More...

	KviPointerList (bool bAutoDelete=true)
	Creates a template list. More...

T *	last ()
	Returns the last item in the list. More...

void	merge (KviPointerList< T > *src)
	Inserts the list src inside this list. More...

T *	next ()
	Returns the next item in the list. More...

KviPointerList< T > &	operator= (KviPointerList< T > &l)
	Clears the list and inserts all the items from the list l. More...

void	prepend (KviPointerList< T > *l)
	Prepends all the items from the list l to this list. More...

void	prepend (const T *d)
	Inserts the item d in the head position. More...

T *	prev ()
	Returns the previous item in the list. More...

bool	remove (int iIndex)
	Removes the item at zero-based position iIndex. More...

bool	removeCurrent ()
	Removes the current iteration item. More...

bool	removeFirst ()
	Removes the first item (if any) More...

bool	removeLast ()
	Removes the firstitem (if any) More...

bool	removeRef (const T *d)
	Removes the item pointed by d (if found in the list) More...

T *	safeCurrent ()
	Returns the current iteration item. More...

void	setAutoDelete (bool bAutoDelete)
	Sets the autodelete flag. More...

void	sort ()
	Sorts this list in ascending order. More...

void	swap (KviPointerList< T > *src)
	Swap the lists. More...

T *	takeFirst ()
	Removes the first element from the list. More...

T *	takeLast ()
	Removes the last item (if any) and returns it. This function obviously never deletes the item (regadless of autoDeletion()). More...

virtual	~KviPointerList ()
	Destroys the list. More...

Protected Member Functions
void	grabFirstAndPrepend (KviPointerList< T > *src)
	Grabs the first element from the list src and puts it as the first element of this list. More...

void	insertBeforeSafe (KviPointerListNode ref, const T d)
	Inserts the item d before the item ref. More...

void	removeCurrentSafe ()
	Removes the current iteration item assuming that it is valid. More...

Protected Attributes
bool	m_bAutoDelete

KviPointerListNode *	m_pAux

KviPointerListNode *	m_pHead

KviPointerListNode *	m_pTail

unsigned int	m_uCount

Friends
class	KviPointerListIterator< T >

Detailed Description

template<typename T>
class KviPointerList< T >

A template double linked list of pointers.

The main advantage of this type of list is speed. Insertion of pointers is very fast when compared to the typical "copy constructor" call used in the "plain type" template list implementations.

Iterating over pointers is also very fast and this class contains an internal iterator that allows to write loops in a compact and clean way. See the first(), next(), current() and findRef() functions for the description of this feature.

There is also a non-const external iterator that you can use to traverse the list concurrently. There is no const iterator (and no const access methods) since the list provides the autoDelete() method which vould implicitly violate constness. If you have to deal with const objects then you need to use a QList instead.

Your objects also do not need to support copy constructors or >= operators. This class will work fine without them as opposed to a plain QList.

This class also supports automatic deletion of the inseted items. See the setAutoDelete() and autoDelete() members for the description of the feature.

Typcal usage:

*   KviPointerList<MyClass> list();
*   list.append(new MyClass());
*   list.append(new MyClass());
*   ...
*   for(MyClass * c = list.first(); c; c = list.next()) doSomethingWith(c);
*   delete list; // autodelete is set to true in the constructor
*

Warning: This class is absolutely NOT thread safe. You must protect concurrent access from multiple threads by using an external synchronization tool (such as KviMutex).

Constructor & Destructor Documentation

template<typename T>

KviPointerList< T >::KviPointerList ( bool bAutoDelete = true )

inline

Creates a template list.

Parameters

bAutoDelete The state of autoDelete()

Returns: KviPointerList<T>

template<typename T>

virtual KviPointerList< T >::~KviPointerList ( )

inlinevirtual

Destroys the list.

If autoDelete() is set to true, all the items are deleted

Member Function Documentation

template<typename T>

void KviPointerList< T >::append ( const T * d )

inline

Appends an item at the end of the list.

Parameters

d	The item to append

Returns: void

template<typename T>

void KviPointerList< T >::append ( KviPointerList< T > * l )

inline

Appends all the items from the list l to this list.

Parameters

l	The source list where to get items

Returns: void

template<typename T>

T* KviPointerList< T >::at ( int idx )

inline

Returns the item at index position.

Sets the iteration pointer to the nTh item in the list and returns that item (or 0 if the index is out of range)

Parameters

idx	The index of the element to return

Returns: T *

template<typename T>

bool KviPointerList< T >::autoDelete ( )

inline

Returns the autodelete flag.

Returns: bool

template<typename T>

void KviPointerList< T >::clear ( )

inline

Removes all the items from the list.

The items are deleted if the autoDelete() flag is set to true

Returns: void

Referenced by KviIsOnNotifyListManager::buildIsOnList(), KviStupidNotifyListManager::buildNickList(), KviIsOnNotifyListManager::buildNotifyList(), KviIsOnNotifyListManager::buildUserhostList(), KviCustomToolBarDescriptor::clear(), UrlDialog::clear(), KviNickServRuleSet::copyFrom(), KviRegisteredUserDataBase::copyFrom(), KviIdentityProfileSet::copyFrom(), KviPointerList< KviPointerHashTableEntry< QString, KviAction > >::copyFrom(), KviKvsPopupMenu::doClear(), KviIsOnNotifyListManager::handleIsOn(), ListWindow::importList(), KviActionManager::killAllKvsUserActions(), KviActionManager::listActionsByCategory(), KviCustomToolBarDescriptor::load(), KviFile::load(), loadBanList(), KviNickServRuleSet::loadPrivate(), KviIdentityProfileSet::loadPrivate(), loadUrlList(), KviChannelListSelector::removeClicked(), KviIdentDaemon::run(), KviDnsResolver::slotHostLookupTerminated(), ListWindow::startOfList(), KviIsOnNotifyListManager::stop(), KviCustomToolBar::syncDescriptor(), KviKvsTimerManager::timerEvent(), and KviPointerList< KviPointerHashTableEntry< QString, KviAction > >::~KviPointerList().

template<typename T>

void KviPointerList< T >::copyFrom ( KviPointerList< T > * l )

inline

Clears the list and inserts all the items from the list l.

Parameters

l	The source list to copy from

Returns: void

Referenced by KviPointerList< KviPointerHashTableEntry< QString, KviAction > >::operator=().

template<typename T>

unsigned int KviPointerList< T >::count ( ) const

inline

Returns the count of the items in the list.

Returns: unsigned int

Referenced by KviInputHistory::add(), KviKvsPopupMenu::addEpilogue(), KviKvsPopupMenu::addItem(), KviKvsPopupMenu::addLabel(), KviKvsPopupMenu::addPopup(), KviKvsPopupMenu::addPrologue(), KviKvsPopupMenu::addSeparator(), ClassEditorWidget::build(), DccBroker::canUnload(), KviAvatarCache::cleanup(), codetester_module_can_unload(), AliasEditorWidget::commit(), KviInputEditor::completion(), DccBroker::dccBoxCount(), DccBroker::dccWindowsCount(), LogViewWindow::deleteCurrent(), KviClassicWindowList::doLayout(), editor_module_can_unload(), AliasEditorWidget::exportAliases(), ClassEditorWidget::exportClasses(), RegisteredUsersDialog::exportClicked(), LogViewWindow::exportLog(), KviCustomToolBarDescriptor::fillToolBar(), KviKvsObject::function_childCount(), KviConsoleWindow::getWindowListTipText(), KviStupidNotifyListManager::handleIsOn(), KviSoundPlayer::havePlayingSounds(), KviInputEditor::historyNext(), KviInputEditor::historyPrev(), KviDnsResolver::hostnameCount(), KviStatusBar::insertPermanentWidgetAtTheEnd(), KviDnsResolver::ipAddressCount(), KviKvsTreeNodeDataList::item(), KviKvsTreeNodeCompositeData::KviKvsTreeNodeCompositeData(), KviLagMeter::lagCheckRegister(), ThemeFunctions::packageThemes(), KviPackageWriter::packInternal(), KviKvsParser::parseBindingOperationParameter(), KviKvsParser::parseExpressionOperandCore(), KviKvsParser::parseOperationRightSide(), KviKvsParser::parseSpecialCommandUnset(), PackThemeDataWidget::parseThemes(), KviStatusBar::queueMessage(), reguser_kvs_cmd_showlist(), reguser_kvs_fnc_list(), KviCustomToolBarDescriptor::removeAction(), KviMaskEditor::removeClicked(), ClassEditorWidget::removeItemChildren(), KviRegisteredUserDataBase::removeMaskByPointer(), KviSharedFilesManager::removeSharedFile(), ClassEditorWidget::renameClass(), ClassEditorWidget::renameFunction(), ClassEditorWidget::renameNamespace(), KviInputEditor::returnPressed(), HttpFileTransfer::runningTransfers(), KviProxyDataBase::save(), KviMediaManager::save(), KviNickServRuleSet::save(), KviCustomToolBarDescriptor::save(), KviInputHistory::save(), KviFile::save(), KviIdentityProfileSet::save(), KviStatusBar::save(), KviKvsPopupMenu::save(), saveBanList(), saveUrlList(), OptionsDialog::searchInSelectors(), AliasEditorWidget::searchReplace(), KviInputEditor::sendKvs(), KviInputEditor::sendPlain(), KviChannelWindow::setModeInList(), LogViewWindow::setupItemList(), KviLagMeter::timerEvent(), DccFileTransfer::transferCount(), ClassEditorWidget::updateClassHierarchy(), and KviMainWindow::~KviMainWindow().

template<typename T>

T* KviPointerList< T >::current ( )

inline

Returns the current iteration item.

A call to this function MUST be preceded by a call to first(),last(),at() or findRef()

Returns: T *

Referenced by KviPointerHashTable< QString, KviActionCategory >::current(), KviPointerHashTable< QString, KviActionCategory >::currentEntry(), KviPointerHashTable< QString, KviActionCategory >::currentKey(), LogViewWindow::filterNext(), and findFrame().

template<typename T>

int KviPointerList< T >::findRef ( const T * d )

inline

Returns the position of an item.

Sets the iteration pointer to the item with pointer d and returns its position (zero based index) in the list or -1 if the item cannot be found

Parameters

d	The element to find

Returns: int

Referenced by KviOptionsWidget::addOptionsWidget(), KviStatusBar::appletExists(), KviStatusBar::appletsPopupActivated(), ClassEditorWidget::build(), ClassEditorWidget::exportClasses(), KviPointerList< KviPointerHashTableEntry< QString, KviAction > >::insertAfter(), KviPointerList< KviPointerHashTableEntry< QString, KviAction > >::insertBefore(), AliasEditorWidget::itemExists(), KviPointerList< KviPointerHashTableEntry< QString, KviAction > >::removeRef(), ClassEditorWidget::removeSelectedItems(), KviIrcNetwork::setCurrentServer(), and KviClassicWindowList::setIterationPointer().

template<typename T>

T* KviPointerList< T >::first ( )

inline

Returns the first item in the list.

Sets the iteration pointer to the first item in the list and returns that item (or 0 if the list is empty)

Returns: T *

template<typename T>

void KviPointerList< T >::grabFirstAndPrepend ( KviPointerList< T > * src )

inlineprotected

Grabs the first element from the list src and puts it as the first element of this list.

Parameters

src	The source list

Returns: void

Referenced by KviPointerList< KviPointerHashTableEntry< QString, KviAction > >::sort().

template<typename T>

void KviPointerList< T >::insert	(	int	iIndex,
		const T *	d
	)

inline

Inserts the item d at the position specified by iIndex.

The position is zero-based. If the specified position is out of the list then the item is appended. Note that this function costs O(n). It's really better to use insertAfter() or insertBefore(), if possible.

Parameters

iIndex	The index where to insert the item
d	The item to insert

Returns: void

Referenced by KviInputHistory::add(), append_mask_to_list(), KviAvatarCache::cleanup(), KviSharedFilesManager::doInsert(), OptionsDialog::fillTreeWidget(), OptionsInstanceManager::getInstance(), KviClassicWindowList::insertButton(), KviMediaManager::insertMediaType(), KviTalWizard::insertPage(), KviInputEditor::returnPressed(), KviInputEditor::sendKvs(), and KviInputEditor::sendPlain().

template<typename T>

void KviPointerList< T >::insertAfter	(	const T *	ref,
		const T *	d
	)

inline

Inserts the item d after the item ref.

If ref is not found in the list, the item is inserted at the end Also sets the current iteration pointer to the newly inserted item

Parameters

ref	The index item
d	The item to insert after ref

Returns: void

template<typename T>

void KviPointerList< T >::insertBefore	(	const T *	ref,
		const T *	d
	)

inline

Inserts the item d before the item ref.

If ref is not found in the list, the item is inserted at the beginning. Also sets the current iteration pointer to the newly inserted item

Parameters

ref	The index item
d	The item to insert before ref

Returns: void

template<typename T>

void KviPointerList< T >::insertBeforeSafe	(	KviPointerListNode *	ref,
		const T *	d
	)

inlineprotected

Inserts the item d before the item ref.

If ref is not found in the list, it inserts d at the beginning Also sets the current iteration pointer to the newly inserted item

Parameters

ref	The source list node
d	The item to insert

Returns: void

Referenced by KviPointerList< KviPointerHashTableEntry< QString, KviAction > >::insert(), and KviPointerList< KviPointerHashTableEntry< QString, KviAction > >::inSort().

template<typename T>

void KviPointerList< T >::inSort ( T * t )

inline

Inserts the item respecting the sorting order inside the list.

The list itself must be already sorted for this to work correctly. There must be a int kvi_compare(const T *p1, const T * p2) that returns a value less than, equal to or greater than zero when the item p1 is considered lower than, equal to or greater than p2.

Parameters

t	The item to insert

Returns: void

Referenced by KviStatusBar::appletsPopupActivated(), and KviStatusBar::registerApplet().

template<typename T>

void KviPointerList< T >::invert ( )

inline

Inverts the elements in the list.

Returns: void

template<typename T>

bool KviPointerList< T >::isEmpty ( ) const

inline

Returns true if the list is empty.

Returns: bool

template<typename T>

KviPointerListIterator<T> KviPointerList< T >::iteratorAt ( int idx )

inline

Returns an iterator pointing to the item at the specified index.

Parameters

idx	The index of the element to return

Returns: KviPointerListIterator<T>

template<typename T>

KviPointerListIterator<T> KviPointerList< T >::iteratorAtCurrent ( )

inline

Returns an iterator pointing to the current item in the list.

A call to this function MUST be preceded by a call to first(),last(),at() or findRef()

Returns: KviPointerListIterator<T>

template<typename T>

KviPointerListIterator<T> KviPointerList< T >::iteratorAtFirst ( )

inline

Returns an iterator pointing to the first item of the list.

Returns: KviPointerListIterator<T>

template<typename T>

KviPointerListIterator<T> KviPointerList< T >::iteratorAtLast ( )

inline

Returns an iterator pointing to the first item of the list.

Returns: KviPointerListIterator<T>

template<typename T>

KviPointerListIterator<T> KviPointerList< T >::iteratorAtRef ( const T * d )

inline

Returns an iterator pointing to the item with pointer d.

Parameters

d	The element to find

Returns: KviPointerListIterator<T>

template<typename T>

T* KviPointerList< T >::last ( )

inline

Returns the last item in the list.

Sets the iteration pointer to the last item in the list and returns that item (or 0 if the list is empty)

Returns: T *

Referenced by KviStatusBar::appletAt(), KviStatusBar::dragMoveEvent(), KviTalWizardPrivate::findLastEnabledPage(), OptionsInstanceManager::getInstance(), KviClassicWindowList::lastItem(), KviPointerList< KviPointerHashTableEntry< QString, KviAction > >::prepend(), KviStatusBar::recalcMinimumHeight(), and KviConsoleWindow::updateUri().

template<typename T>

void KviPointerList< T >::merge ( KviPointerList< T > * src )

inline

Inserts the list src inside this list.

It respects the sort order. The src list elements are removed.

Parameters

src	The list to insert

Returns: void

Referenced by KviPointerList< KviPointerHashTableEntry< QString, KviAction > >::sort().

template<typename T>

T* KviPointerList< T >::next ( )

inline

Returns the next item in the list.

Sets the iteration pointer to the next item in the list and returns that item (or 0 if the end of the list has been reached) A call to this function MUST be preceded by a succesfull call to first(),last(),at() or findRef().

Returns: T *

template<typename T>

KviPointerList<T>& KviPointerList< T >::operator= ( KviPointerList< T > & l )

inline

Clears the list and inserts all the items from the list l.

This is just an alias to copyFrom(l)

Parameters

l	The source list to copy from

Returns: KviPointerList<T> &

template<typename T>

void KviPointerList< T >::prepend ( KviPointerList< T > * l )

inline

Prepends all the items from the list l to this list.

Parameters

l	The source list where to get items

Returns: void

Referenced by KviPointerList< KviPointerHashTableEntry< QString, KviAction > >::insertBefore(), KviPointerList< KviPointerHashTableEntry< QString, KviAction > >::prepend(), KviKvsTreeNodeDataList::prependItem(), and KviStatusBar::queueMessage().

template<typename T>

void KviPointerList< T >::prepend ( const T * d )

inline

Inserts the item d in the head position.

Parameters

d	The element to insert

Returns: void

template<typename T>

T* KviPointerList< T >::prev ( )

inline

Returns the previous item in the list.

Sets the iteration pointer to the previous item in the list and returns that item (or 0 if the beginning of the list has been reached). A call to this function MUST be preceded by a succesfull call to first(),last(),at() or findRef()

Returns: T *

Referenced by KviStatusBar::dragMoveEvent(), KviHistoryWindow::fill(), KviTalWizardPrivate::findLastEnabledPage(), KviTalWizardPrivate::findPrevEnabledPage(), OptionsInstanceManager::getInstance(), KviPointerList< KviPointerHashTableEntry< QString, KviAction > >::prepend(), KviClassicWindowList::prevItem(), KviStatusBar::recalcMinimumHeight(), and KviChannelWindow::removeMasks().

template<typename T>

bool KviPointerList< T >::remove ( int iIndex )

inline

Removes the item at zero-based position iIndex.

Does nothing and returns false if iIndex is out of the list. Please note that this function costs O(n).

Parameters

iIndex The index where to remove the item

Returns: bool

Referenced by KviCustomToolBarDescriptor::removeAction().

template<typename T>

bool KviPointerList< T >::removeCurrent ( )

inline

Removes the current iteration item.

Returns true if the current iteration item was valid (and was removed) and false otherwise.

Returns: bool

Referenced by BanFrame::removeBan().

template<typename T>

void KviPointerList< T >::removeCurrentSafe ( )

inlineprotected

Removes the current iteration item assuming that it is valid.

Returns: void

Referenced by KviPointerList< KviPointerHashTableEntry< QString, KviAction > >::remove(), KviPointerList< KviPointerHashTableEntry< QString, KviAction > >::removeCurrent(), and KviPointerList< KviPointerHashTableEntry< QString, KviAction > >::removeRef().

template<typename T>

bool KviPointerList< T >::removeFirst ( )

inline

Removes the first item (if any)

The item is deleted if autoDelete() is set to true

Returns: bool

Referenced by KviIsOnNotifyListManager::buildIsOnList(), KviIsOnNotifyListManager::buildUserhostList(), KviPointerList< KviPointerHashTableEntry< QString, KviAction > >::clear(), KviSensitiveThread::dequeueEvent(), ListWindow::flush(), KviIsOnNotifyListManager::handleIsOn(), KviIsOnNotifyListManager::handleUserhost(), KviLagMeter::lagCheckComplete(), KviLagMeter::lagCheckRegister(), KviStatusBar::messageTimerFired(), KviKvsTreeNodeInstructionBlock::releaseFirst(), KviKvsTreeNodeDataList::releaseFirst(), and DccChatThread::tryFlushOutBuffers().

template<typename T>

bool KviPointerList< T >::removeLast ( )

inline

Removes the firstitem (if any)

The item is deleted if autoDelete() is set to true

Returns: bool

Referenced by KviInputHistory::add(), KviInputEditor::returnPressed(), KviInputEditor::sendKvs(), and KviInputEditor::sendPlain().

template<typename T>

bool KviPointerList< T >::removeRef ( const T * d )

inline

Removes the item pointed by d (if found in the list)

The item is deleted if the autoDelete() flag is set to true) Returns true if the item was in the list and false otherwise.

Parameters

d	The pointer to the item to delete

Returns: bool

Referenced by KviAction::actionDestroyed(), KviStatusBar::appletsPopupActivated(), KviOptionsWidget::childEvent(), KviOptionsWidget::childOptionsWidgetDestroyed(), KviKvsEvent::clearScriptHandlers(), KviMainWindow::closeWindow(), KviKvsObject::disconnectSignal(), KviOptionsWidget::eventFilter(), KviCustomToolBarDescriptor::fillToolBar(), KviMainWindow::freeAccelleratorKeySequence(), KviIsOnNotifyListManager::handleIsOn(), KviIsOnNotifyListManager::handleUserhost(), KviChannelWindow::internalMask(), KviLagMeter::lagCheckAbort(), UrlDialog::remove(), KviPointerHashTable< QString, KviActionCategory >::remove(), KviCustomToolBarDescriptor::removeAction(), KviKvsEvent::removeHandler(), AliasEditorWidget::removeItem(), KviClassicWindowList::removeItem(), KviKvsPopupMenu::removeItemByName(), AliasEditorWidget::removeItemChildren(), KviRegisteredUser::removeMask(), KviRegisteredUserDataBase::removeMaskByPointer(), KviKvsEventManager::removeModuleRawHandler(), KviPointerHashTable< QString, KviActionCategory >::removeRef(), KviKvsEventManager::removeScriptRawHandler(), KviOptionsWidget::removeSelector(), KviSharedFilesManager::removeSharedFile(), KviIdentDaemon::run(), KviStatusBarAppletDescriptor::unregisterApplet(), KviStatusBar::unregisterApplet(), KviIrcConnection::unregisterChannel(), KviKvsObject::unregisterChild(), KviKvsObjectClass::unregisterChildClass(), KviKvsObject::unregisterConnection(), KviIrcContext::unregisterContextWindow(), KviIrcContext::unregisterDataStreamMonitor(), DccBroker::unregisterDccBox(), DccBroker::unregisterDccWindow(), KviIrcContext::unregisterDeadChannel(), KviIrcContext::unregisterDeadQuery(), KviMainWindow::unregisterModuleExtensionToolBar(), KviKvsObjectController::unregisterObject(), KviModuleExtensionDescriptor::unregisterObject(), KviKvsAsyncOperationManager::unregisterOperation(), KviIrcConnection::unregisterQuery(), KviThreadManager::unregisterSlaveThread(), KviSoundPlayer::unregisterSoundThread(), KviFileTransferManager::unregisterTransfer(), CodeTesterWindow::~CodeTesterWindow(), DccFileTransfer::~DccFileTransfer(), HelpWidget::~HelpWidget(), HelpWindow::~HelpWindow(), HttpFileTransfer::~HttpFileTransfer(), KviAsyncAvatarSelectionDialog::~KviAsyncAvatarSelectionDialog(), KviKvsCallbackFileDialog::~KviKvsCallbackFileDialog(), KviKvsCallbackImageDialog::~KviKvsCallbackImageDialog(), KviKvsCallbackMessageBox::~KviKvsCallbackMessageBox(), KviKvsCallbackTextInput::~KviKvsCallbackTextInput(), KviToolBarGraphicalApplet::~KviToolBarGraphicalApplet(), LinksWindow::~LinksWindow(), ListWindow::~ListWindow(), RegistrationWizard::~RegistrationWizard(), ScriptEditorImplementation::~ScriptEditorImplementation(), SlowPasteController::~SlowPasteController(), SocketSpyWindow::~SocketSpyWindow(), and UserWindow::~UserWindow().

template<typename T>

T* KviPointerList< T >::safeCurrent ( )

inline

Returns the current iteration item.

A call to this function should be preceded by a call to first(),last(),at() or findRef(). This function will return a NULL pointer if the current item has been invalidated due to a remove operation.

Returns: T *

template<typename T>

void KviPointerList< T >::setAutoDelete ( bool bAutoDelete )

inline

Sets the autodelete flag.

When this flag is on (default), all the items are deleted when removed from the list (or when the list is destroyed or cleared explicitly)

Parameters

bAutoDelete The state of the autoDelete()

Returns: void

Referenced by KviIrcConnectionAsyncData< KviAsyncWhoisInfo >::add(), KviKvsEvent::addHandler(), KviRegisteredUserDataBase::addMask(), KviIdentityProfileSet::addProfile(), KviKvsEventManager::addRawHandler(), KviNickServRuleSet::addRule(), KviSharedFilesManager::addSharedFile(), AliasEditorWidget::AliasEditorWidget(), AliasEditorWidget::aliasExists(), AliasEditorWidget::aliasRefresh(), avatar_module_init(), ClassEditorWidget::build(), KviIsOnNotifyListManager::buildIsOnList(), KviIsOnNotifyListManager::buildUserhostList(), KviSharedFilesManager::cleanup(), KviAvatarCache::cleanup(), KviModuleManager::cleanupUnusedModules(), KviProxyDataBase::clear(), KviKvsObjectController::clearInstances(), KviKvsEvent::clearScriptHandlers(), KviKvsObjectController::clearUserClasses(), codetester_module_init(), KviKvsKernel::completeCommandAllocateResult(), KviKvsKernel::completeFunction(), KviKvsKernel::completeFunctionAllocateResult(), KviKvsKernel::completeModuleCommand(), KviKvsKernel::completeModuleFunction(), KviInputEditor::completion(), KviKvsObject::connectSignal(), KviNickServRuleSet::copyFrom(), KviIdentityProfileSet::copyFrom(), DccBroker::DccBroker(), DccChatThread::DccChatThread(), ActionEditor::deleteActions(), KviKvsTimerManager::deleteAllTimers(), LogViewWindow::deleteCurrent(), dialog_module_init(), editor_module_init(), KviKvsObject::emitSignal(), AliasEditorWidget::exportAliases(), ClassEditorWidget::exportClasses(), LogViewWindow::exportLog(), KviCustomToolBarDescriptor::fillToolBar(), OptionsDialog::fillTreeWidget(), OptionsInstanceManager::getInstance(), KviIsOnNotifyListManager::handleIsOn(), KviIsOnNotifyListManager::handleUserhost(), help_module_init(), ListWindow::importList(), HttpFileTransfer::init(), DccFileTransfer::init(), KviKvsObject::killAllChildrenWithClass(), KviActionManager::killAllKvsUserActions(), KviKvsObjectController::killAllObjectsWithClass(), KviThreadManager::killPendingEventsByReceiver(), KviFileTransferManager::killTerminatedTransfers(), KviClassicWindowList::KviClassicWindowList(), KviCustomToolBarDescriptor::KviCustomToolBarDescriptor(), KviDnsResolverResult::KviDnsResolverResult(), KviInputEditor::KviInputEditor(), KviInputHistory::KviInputHistory(), KviIrcConnection::KviIrcConnection(), KviIrcMessage::KviIrcMessage(), KviIrcNetwork::KviIrcNetwork(), KviIsOnNotifyListManager::KviIsOnNotifyListManager(), KviKvsAsyncOperationManager::KviKvsAsyncOperationManager(), KviKvsObject::KviKvsObject(), KviKvsObjectClass::KviKvsObjectClass(), KviKvsObjectController::KviKvsObjectController(), KviKvsPopupMenu::KviKvsPopupMenu(), KviKvsTreeNodeCompositeData::KviKvsTreeNodeCompositeData(), KviKvsTreeNodeDataList::KviKvsTreeNodeDataList(), KviKvsTreeNodeInstructionBlock::KviKvsTreeNodeInstructionBlock(), KviKvsTreeNodeSpecialCommandClass::KviKvsTreeNodeSpecialCommandClass(), KviKvsTreeNodeSpecialCommandDefpopupLabelPopup::KviKvsTreeNodeSpecialCommandDefpopupLabelPopup(), KviKvsTreeNodeSpecialCommandSwitch::KviKvsTreeNodeSpecialCommandSwitch(), KviKvsVariantList::KviKvsVariantList(), KviLagMeter::KviLagMeter(), KviMainWindow::KviMainWindow(), KviMediaManager::KviMediaManager(), KviModuleExtensionDescriptor::KviModuleExtensionDescriptor(), KviOptionsWidget::KviOptionsWidget(), KviPackageWriter::KviPackageWriter(), KviProxyDataBase::KviProxyDataBase(), KviRegisteredUser::KviRegisteredUser(), KviRegisteredUserDataBase::KviRegisteredUserDataBase(), KviSensitiveThread::KviSensitiveThread(), KviSoundPlayer::KviSoundPlayer(), KviStatusBar::KviStatusBar(), KviStatusBarAppletDescriptor::KviStatusBarAppletDescriptor(), KviStupidNotifyListManager::KviStupidNotifyListManager(), KviTalWizard::KviTalWizard(), KviThreadManager::KviThreadManager(), KviToolBarGraphicalApplet::KviToolBarGraphicalApplet(), KviLagMeter::lagCheckAbort(), lamerizer_module_init(), links_module_init(), list_module_init(), KviActionManager::listActionsByCategory(), ListWindow::ListWindow(), KviKvsPopupManager::load(), KviKvsAliasManager::load(), KviIrcServerDataBase::load(), KviTextIconManager::load(), ClassEditorWidget::loadNotBuiltClasses(), KviNickServRuleSet::loadPrivate(), KviIdentityProfileSet::loadPrivate(), KviKvsEventManager::loadRawEvents(), mediaplayer_module_init(), AliasEditorWidget::namespaceExists(), options_module_cleanup(), ThemeManagementDialog::packTheme(), KviKvsParser::parseBindingOperationParameter(), KviKvsParser::parseCommaSeparatedParameterListNoTree(), KviKvsParser::parseExpressionOperandCore(), KviKvsParser::parseOperationRightSide(), KviKvsParser::parseSpecialCommandUnset(), KviHttpRequest::processHeader(), KviInputEditor::rebuildTextBlocks(), KviAction::registerAction(), KviKvsObject::registerConnection(), KviIrcContext::registerContextWindow(), KviIrcContext::registerDataStreamMonitor(), KviIrcContext::registerDeadChannel(), KviIrcContext::registerDeadQuery(), KviModuleExtensionManager::registerExtension(), KviFileTransferManager::registerTransfer(), reguser_module_init(), KviKvsTreeNodeInstructionBlock::releaseFirst(), KviKvsTreeNodeDataList::releaseFirst(), KviKvsEventManager::removeAllModuleAppHandlers(), KviKvsEventManager::removeAllModuleRawHandlers(), KviKvsEventManager::removeAllScriptRawHandlers(), KviMaskEditor::removeClicked(), KviChannelListSelector::removeClicked(), ClassEditorWidget::removeItemChildren(), AliasEditorWidget::removeSelectedItems(), ClassEditorWidget::removeSelectedItems(), ClassEditorWidget::renameClass(), ClassEditorWidget::renameFunction(), ClassEditorWidget::renameNamespace(), KviKvsParser::report(), KviKvsRunTimeContext::report(), rijndael_module_init(), rot13_module_init(), KviIdentDaemon::run(), KviKvsTimerManager::scheduleKill(), ScriptEditorWidgetColorOptions::ScriptEditorWidgetColorOptions(), KviKvsVariantList::setAutoDelete(), KviChannelWindow::setModeInList(), socketspy_module_init(), spaste_module_init(), ListWindow::startOfList(), KviSoundPlayer::stopAllSoundThreads(), term_module_init(), theme_kvs_cmd_pack(), KviChannelWindow::toggleListModeEditor(), torrent_module_init(), KviModuleManager::unloadAllModules(), KviModuleExtensionManager::unregisterExtensionsByModule(), ClassEditorWidget::updateClassHierarchy(), url_module_init(), window_module_init(), KviAction::~KviAction(), KviSensitiveThread::~KviSensitiveThread(), ListWindow::~ListWindow(), and RegistrationWizard::~RegistrationWizard().

template<typename T>

void KviPointerList< T >::sort ( )

inline

Sorts this list in ascending order.

There must be an int kvi_compare(const T *p1, const T *p2) function which returns a value less than, equal to or greater than zero when the item p1 is considered lower than, equal to or greater than p2.