Qt 4.8: QList< T > Class Template Reference

QListData::Data * d

Definition: qlist.h:118

QListData::shared_null

static Data shared_null

Definition: qlist.h:86

QListData::Data::sharable

QBasicAtomicInt ref

Definition: qlist.h:73

◆ QList() [2/2]

template<typename T>

QList< T >::QList ( const QList< T > & other )

inline

Constructs a copy of other.

This operation takes constant time, because QList is implicitly shared. This makes returning a QList from a function very fast. If a shared instance is modified, it will be copied (copy-on-write), and that takes linear time.

See also: operator=()

Definition at line 122 of file qlist.h.

122 : d(l.d) { d->ref.ref(); if (!d->sharable) detach_helper(); }

QList::detach_helper

void detach_helper()

Definition: qlist.h:723

QBasicAtomicInt::ref

bool ref()

Definition: qatomic_alpha.h:495

uint sharable

Definition: qlist.h:75

QListData::Data * d

Definition: qlist.h:118

QBasicAtomicInt ref

Definition: qlist.h:73

QFactoryLoader * l

Definition: qimagewriter.cpp:152

◆ ~QList()

template<typename T >

Q_OUTOFLINE_TEMPLATE QList< T >::~QList ( )

Destroys the list.

References to the values in the list and all iterators of this list become invalid.

Definition at line 729 of file qlist.h.

 {
     if (!d->ref.deref())
         free(d);
 }

Functions

◆ append() [1/2]

template<typename T>

Q_OUTOFLINE_TEMPLATE void QList< T >::append ( const T & value )

Inserts value at the end of the list.

Example:

QList<QString> list;
list.append("one");
list.append("two");
list.append("three");
// list: ["one", "two", "three"]

This is the same as list.insert(size(), value).

This operation is typically very fast (constant time), because QList preallocates extra space on both sides of its internal buffer to allow for fast growth at both ends of the list.

See also: operator<<(), prepend(), insert()

Definition at line 507 of file qlist.h.

 {
     if (d->ref != 1) {
         Node *n = detach_helper_grow(INT_MAX, 1);
         QT_TRY {
             node_construct(n, t);
         } QT_CATCH(...) {
             --d->end;
             QT_RETHROW;
         }
     } else {
         if (QTypeInfo<T>::isLarge || QTypeInfo<T>::isStatic) {
             Node *n = reinterpret_cast<Node *>(p.append());
             QT_TRY {
                 node_construct(n, t);
             } QT_CATCH(...) {
                 --d->end;
                 QT_RETHROW;
             }
         } else {
             Node *n, copy;
             node_construct(&copy, t); // t might be a reference to an object in the array
             QT_TRY {
                 n = reinterpret_cast<Node *>(p.append());;
             } QT_CATCH(...) {
                 node_destruct(&copy);
                 QT_RETHROW;
             }
             *n = copy;
         }
     }
 }

◆ append() [2/2]

template<typename T>

void QList< T >::append ( const QList< T > & value )

inline

Appends the items of the value list to this list.

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Since: 4.5

See also: operator<<(), operator+=()

Definition at line 841 of file qlist.h.

 {
     *this += t;
 }

◆ at()

template<typename T >

const T & QList< T >::at ( int i ) const

inline

Returns the item at index position i in the list.

i must be a valid index position in the list (i.e., 0 <= i < size()).

This function is very fast (constant time).

See also: value(), operator[]()

Definition at line 468 of file qlist.h.

469 { Q_ASSERT_X(i >= 0 && i < p.size(), "QList<T>::at", "index out of range");

470 return reinterpret_cast<Node *>(p.at(i))->t(); }

Definition: qdeclarativexmlhttprequest.cpp:224

QListData p

Definition: qlist.h:118

int size() const

Definition: qlist.h:98

void ** at(int i) const

Definition: qlist.h:100

Q_ASSERT_X

#define Q_ASSERT_X(cond, where, what)

Definition: qglobal.h:1837

◆ back() [1/2]

template<typename T>

T & QList< T >::back ( )

inline

This function is provided for STL compatibility.

It is equivalent to last(). The list must not be empty. If the list can be empty, call isEmpty() before calling this function.

Definition at line 300 of file qlist.h.

Referenced by QMdiAreaPrivate::nextVisibleSubWindow().

300 { return last(); }

T & last()

Returns a reference to the last item in the list.

Definition: qlist.h:284

◆ back() [2/2]

template<typename T>

const T & QList< T >::back ( ) const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 301 of file qlist.h.

301 { return last(); }

Referenced by QFileSystemModelPrivate::_q_directoryChanged(), QScriptDebuggerConsoleWidgetPrivate::_q_onCompletionTaskFinished(), QGraphicsSceneBspTreeIndexPrivate::_q_updateSortCache(), QDeclarativeImportsPrivate::add(), QDeclarativeTimeLinePrivate::advance(), QCopChannel::answer(), QSyntaxHighlighterPrivate::applyFormatChanges(), QStateMachinePrivate::applyProperties(), QTextEngine::calculateTabWidth(), QWorkspace::cascade(), QRingBuffer< T >::clear(), QGraphicsSceneBspTreeIndexPrivate::climbTree(), QTreeViewPrivate::columnRanges(), QPatternist::UnlimitedContainer::compressOperands(), convertFlags(), QNetworkCookieJar::cookiesForUrl(), createInterfaces(), QCopChannel::detach(), QSvgG::draw(), QSvgTinyDocument::draw(), QSvgSwitch::draw(), QAbstractItemModel::encodeData(), QThreadPoolPrivate::enqueueTask(), QGraphicsItemPrivate::ensureSequentialSiblingIndex(), QGraphicsScenePrivate::ensureSequentialTopLevelSiblingIndexes(), QListModel::ensureSorted(), QTreeModel::ensureSorted(), QGraphicsScenePrivate::ensureSortedTopLevelItems(), QStateMachinePrivate::enterStates(), QStateMachinePrivate::exitStates(), fallbackFamilies(), findAllLibCrypto(), findAllLibSsl(), QMdi::MinOverlapPlacer::getCandidatePlacements(), QListModel::insert(), QGraphicsItemAnimationPrivate::insertUniquePair(), interfaceListing(), QSimplexConstraint::invert(), QAxScript::load(), QAxScriptManager::load(), QScript::QObjectData::mark(), QItemSelection::merge(), QDirModel::mimeData(), QFileSystemModel::mimeData(), QBBWindow::offset(), QHttpHeader::parse(), QWorkspacePrivate::place(), postProcess(), QDeclarativeBasePositioner::prePositioning(), QTDSDriver::primaryIndex(), QXmlSimpleReaderPrivate::processElementEmptyTag(), QDeclarativeDomObjectPrivate::properties(), qax_startServer(), qax_stopServer(), QClassFactory::QClassFactory(), qDBusRemoveTimeout(), QDeclarativeImportDatabase::QDeclarativeImportDatabase(), qGetODBCVersion(), qSplitTableQualifier(), QtPrivate::QStringList_removeDuplicates(), QApplicationPrivate::qt_mac_apply_settings(), qt_mac_send_posted_gl_updates(), qt_mac_update_child_gl_widgets(), qt_mac_update_intersected_gl_widgets(), qt_wce_delete_action_list(), qt_win_extract_filter(), qt_win_filter(), qt_win_get_save_file_name(), rasterFallbacksMask(), MetaObjectGenerator::readClassInfo(), QHttpNetworkReplyPrivate::removeAutoDecompressHeader(), QWindowsFileSystemWatcherEngine::removePaths(), QCoreApplication::removePostedEvents(), QDeclarativeImportsPrivate::resolvedUri(), QSvgHandler::resolveGradients(), QAxScriptManager::scriptFileFilter(), QTreeViewPrivate::select(), QAbstractItemView::selectedIndexes(), QCoreApplicationPrivate::sendPostedEvents(), QAxBase::setControl(), QBBWindow::setGeometry(), QHttpNetworkHeaderPrivate::setHeaderField(), QMacPasteboard::setMimeData(), QBBWindow::setScreen(), QPrintDialogPrivate::setTabs(), QSimplex::simplifyConstraints(), sm_setProperty(), QStringListModel::sort(), QFileSystemModelPrivate::sortChildren(), QGraphicsSceneBspTreeIndexPrivate::sortItems(), QThreadPoolPrivate::stealRunnable(), QTextBlockFormat::tabPositions(), MetaObjectGenerator::tryCache(), QPatternist::ExpressionSequence::typeCheck(), QTableModel::updateRowIndexes(), QBBWindow::updateVisibility(), QBBWindow::updateZorder(), QTextOdfWriter::writeAll(), QTextOdfWriter::writeBlockFormat(), writeTypesEnum(), QApplicationPrivate::x11_apply_settings(), QMenuBarPrivate::QMacMenuBarPrivate::~QMacMenuBarPrivate(), and QMenuPrivate::QMacMenuPrivate::~QMacMenuPrivate().

T & last()

Returns a reference to the last item in the list.

Definition: qlist.h:284

◆ begin() [1/2]

template<typename T>

QList::iterator QList< T >::begin ( )

inline

Returns an STL-style iterator pointing to the first item in the list.

See also: constBegin(), end()

Definition at line 267 of file qlist.h.

267 { detach(); return reinterpret_cast<Node *>(p.begin()); }

void detach()

Definition: qlist.h:139

Definition: qdeclarativexmlhttprequest.cpp:224

QListData p

Definition: qlist.h:118

QListData::begin

void ** begin() const

Definition: qlist.h:101

◆ begin() [2/2]

template<typename T>

QList::const_iterator QList< T >::begin ( ) const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 268 of file qlist.h.

268 { return reinterpret_cast<Node *>(p.begin()); }

Definition: qdeclarativexmlhttprequest.cpp:224

Referenced by QGraphicsScenePrivate::_q_emitUpdated(), QStateMachinePrivate::_q_start(), QFtpPrivate::_q_startNextCommand(), QAbstractSocketPrivate::_q_testConnection(), QGraphicsSceneBspTreeIndexPrivate::_q_updateIndex(), QUnixSocket::abort(), QFtpPI::abort(), QPacketProtocolPrivate::aboutToClose(), QDBusConnectionPrivate::activateCall(), Maemo::IcdPrivate::addrinfo(), QTextHtmlImporter::appendBlock(), QTextHtmlImporter::appendNodeText(), QDeclarativeState::apply(), QSyntaxHighlighterPrivate::applyFormatChanges(), QDeclarativeComponentPrivate::begin(), QDeclarativeComponentPrivate::beginDeferred(), QDeclarativeEngineDebugService::buildStatesList(), QGraphicsAnchorLayoutPrivate::calculateGraphs(), QDeclarativeTransitionManager::cancel(), QStatePrivate::childStates(), QmlJSDebugger::LiveRubberBandSelectionManipulator::clear(), QmlJSDebugger::LiveSingleSelectionManipulator::clear(), QPacketProtocol::clear(), QListModel::clear(), QTreeModel::clear(), FlatListModel::clear(), QDeclarativeScriptParser::clear(), QTestEventList::clear(), QDockAreaLayoutInfo::clear(), QByteDataBuffer::clear(), QTextDocumentPrivate::clear(), QToolBarAreaLayoutInfo::clear(), QHostInfoLookupManager::clear(), QResourcePrivate::clear(), ModelNode::clear(), QCalendarDateValidator::clear(), QWaylandMimeData::clearAll(), QSimplex::clearDataStructures(), QDirPrivate::clearFileLists(), QTextDocumentPrivate::clearFrame(), QFutureSynchronizer< T >::clearFutures(), QStateMachinePrivate::clearHistory(), QHttpNetworkReplyPrivate::clearHttpLayerInformation(), QFtpPI::clearPendingCommands(), Maemo::IcdPrivate::clearState(), QPSQLDriver::close(), QWSPcMouseHandlerPrivate::closeDevices(), QDeclarativeCompiler::compile(), QDeclarativeTransitionManager::complete(), QDeclarativeComponentPrivate::complete(), QmlJSDebugger::LiveSelectionTool::createContextMenu(), QSslSocketPrivate::createPlainSocket(), QWaylandClipboard::createSelectionOffer(), QDeclarativePackagePrivate::data_clear(), QObjectPrivate::deleteChildren(), QScriptDebuggerLocalsModelPrivate::depopulate(), QBBIntegration::destroyDisplays(), QmlJSDebugger::LiveSingleSelectionManipulator::end(), QmlJSDebugger::LiveRubberBandSelectionManipulator::end(), QWindowSurface::endPaint(), QGLWindowSurface::endPaint(), QStateMachinePrivate::exitStates(), QNlaThread::fetchConfigurations(), QDeclarativeXMLHttpRequest::fillHeadersList(), QItemSelectionModelPrivate::finalize(), QMdi::MinOverlapPlacer::findMaxOverlappers(), QIcdEngine::finishAsyncConfigurationUpdate(), QNetworkReplyImplPrivate::finished(), QFbScreen::generateRects(), QScanThread::getConfigurations(), QNlaThread::getConfigurations(), QNetworkReplyImplPrivate::handleNotifications(), QMainWindowLayout::hover(), QSslSocketPrivate::init(), QPainterState::init(), initializeDb(), QSslSocketBackendPrivate::initSslContext(), QSettingsPrivate::iniUnescapedStringList(), QTextDocumentLayoutPrivate::layoutBlock(), QTextDocumentLayoutPrivate::layoutCell(), QUrlModel::layoutChanged(), QDeclarativeVMEMetaObject::list_clear(), QDeclarativeDomDocument::load(), QResourcePrivate::load(), QTreeModel::mimeData(), QDeclarativeStatePrivate::operations_clear(), operator>>(), QDeclarativeDirParser::parse(), parseServerList(), QTextHtmlParser::parseTag(), QCompleter::pathFromIndex(), QMacWindowFader::performFade(), QDeclarativeGridViewPrivate::positionViewAtIndex(), QDeclarativeListViewPrivate::positionViewAtIndex(), prepareEngineForMatch(), QGraphicsSceneBspTreeIndexPrivate::purgeRemovedItems(), qDBusParametersForMethod(), qt_cleanup(), QFileDialogPrivate::qt_mac_filedialog_event_proc(), qt_wce_delete_action_list(), QMainWindowLayout::qtmacToolbarDelegate(), QTreeWidgetItem::read(), QActionPrivate::redoGrabAlternate(), registerFont(), QTextFramePrivate::remove_me(), QGraphicsScene::render(), QThreadPoolPrivate::reset(), QDeclarativeCompiler::reset(), QGraphicsSceneBspTreeIndexPrivate::resetIndex(), QGraphicsAnchorLayoutPrivate::restoreVertices(), Maemo::IcdPrivate::scan(), QmlJSDebugger::LiveSelectionTool::selectedItemsChanged(), QJSDebugService::sendMessages(), QDeclarativeDebugTrace::sendMessages(), QSimplex::setConstraints(), QFutureSynchronizer< T >::setFuture(), ModelNode::setListValue(), QUrlModel::setUrls(), QStringListModel::sort(), QFileSystemModelPrivate::sortChildren(), QSslSocketBackendPrivate::startHandshake(), Maemo::IcdPrivate::state(), Maemo::IcdPrivate::statistics(), QTreeWidgetItem::takeChildren(), QPatternist::ParserContext::templateParametersHandled(), QUnifiedTimer::timerEvent(), QStatePrivate::transitions(), QDockAreaLayoutInfo::unnest(), QmlJSDebugger::LiveSingleSelectionManipulator::update(), QFactoryLoader::updateDir(), QAudioDeviceInfoInternal::updateLists(), QFontDialogPrivate::updateStyles(), QIconEngineV2::virtual_hook(), QPixmapIconEngine::virtual_hook(), QIconLoaderEngine::virtual_hook(), QHostInfoLookupManager::work(), QDBusServer::~QDBusServer(), QDeclarativePixmapReader::~QDeclarativePixmapReader(), QGLEngineSharedShaders::~QGLEngineSharedShaders(), QTextDocumentPrivate::~QTextDocumentPrivate(), QTreeWidgetItem::~QTreeWidgetItem(), QMenuBarPrivate::QWceMenuBarPrivate::~QWceMenuBarPrivate(), and QWSServerPrivate::~QWSServerPrivate().

QListData p

Definition: qlist.h:118

QListData::begin

void ** begin() const

Definition: qlist.h:101

◆ clear()

template<typename T >

Q_OUTOFLINE_TEMPLATE void QList< T >::clear ( )

Removes all items from the list.

See also: removeAll()

Definition at line 764 of file qlist.h.

 {
     *this = QList<T>();
 }

◆ constBegin()

template<typename T>

QList::const_iterator QList< T >::constBegin ( ) const

inline

Returns a const STL-style iterator pointing to the first item in the list.

See also: begin(), constEnd()

Definition at line 269 of file qlist.h.

Referenced by QItemSelectionModelPrivate::_q_layoutAboutToBeChanged(), QWindowsFileSystemWatcherEngine::addPaths(), QMacPasteboardMime::all(), QCopChannel::answer(), QDBusMarshaller::append(), QCoreApplication::applicationFilePath(), QSvgStyle::apply(), QApplicationPrivate::applyX11SpecificCommandLineArguments(), QPatternist::MultiItemType::atomizedType(), QPatternist::UserFunctionCallsite::bindVariables(), boundingRectOfFloatsInSelection(), QPatternist::CallTargetDescription::checkCallsiteCircularity(), QHttpPartPrivate::checkHeaderCreated(), QPatternist::checkVariableCircularity(), QStatePrivate::childStates(), QAbstractItemViewPrivate::clearOrRemove(), QPdfBaseEnginePrivate::closePrintDevice(), QPatternist::ExpressionSequence::compress(), QApplication::compressEvent(), QPatternist::VariableDeclaration::contains(), QHttpNetworkHeaderPrivate::contentLength(), QMacPasteboardMime::convertor(), QPatternist::FunctionFactoryCollection::createFunctionCall(), QVNCIntegration::createPlatformWindow(), debugVariantList(), QPatternist::Template::dependencies(), QPatternist::MultiItemType::displayName(), QPatternist::FunctionSignature::displayName(), QSvgSwitch::draw(), QSqlDatabase::drivers(), QDirModel::dropMimeData(), QFileSystemModel::dropMimeData(), QPatternist::GeneralComparison::evaluateEBV(), QPatternist::ConcatFN::evaluateSingleton(), QPatternist::ExpressionSequence::evaluateToSequenceReceiver(), QPatternist::FunctionCall::expectedOperandTypes(), familyList(), QIconModeViewBase::filterStartDrag(), findChildObject(), QFontDatabase::findFont(), QMacPasteboardMime::flavorToMime(), fontFile(), QProcessEnvironmentPrivate::fromList(), QPatternist::FunctionFactoryCollection::functionSignatures(), generateSubObjectXml(), QFileInfoGatherer::getFileInfos(), QWindowSystemInterface::handleTouchEvent(), QHttpNetworkRequestPrivate::header(), QHttpNetworkHeaderPrivate::headerFieldValues(), QStatePrivate::historyStates(), QFont::insertSubstitutions(), QNetworkInterfaceManager::interfaceFromIndex(), QNetworkInterfaceManager::interfaceFromName(), QAxServerBase::internalCreate(), QPatternist::Expression::invokeOptimizers(), QPatternist::MultiItemType::isAtomicType(), QPatternist::FunctionFactoryCollection::isAvailable(), QItemSelectionModel::isColumnSelected(), QPatternist::MultiItemType::isNodeType(), QItemSelectionModel::isRowSelected(), QPatternist::MultiItemType::itemMatches(), QCoreApplication::libraryPaths(), QDBusMessagePrivate::makeLocal(), QIdentityProxyModel::mapSelectionFromSource(), QIdentityProxyModel::mapSelectionToSource(), QIdentityProxyModel::match(), QDir::match(), mergeKeySets(), QDBusInterfacePrivate::metacall(), QPatternist::DistinctIterator::next(), QPatternist::UnlimitedContainer::operandsUnionType(), operator<<(), parseAnimateColorNode(), QAuthenticatorPrivate::parseHttpResponse(), QDBusAdaptorConnector::polish(), QSvgStructureNode::previousSiblingNode(), QPatternist::ExpressionSequence::properties(), QPatternist::Template::properties(), qDBusFindAdaptorConnector(), qDBusParametersForMethod(), QFileDialogPrivate::qt_mac_filedialog_filter_proc(), qt_mac_make_filters_list(), QUnixPrintWidgetPrivate::QUnixPrintWidgetPrivate(), QFactoryLoader::refreshAll(), registerFont(), QNetworkAccessHttpBackend::replyDownloadMetaData(), QSvgStyle::revert(), QNetworkAccessHttpBackend::sendCacheContents(), QWinSettingsPrivate::set(), QApplication::setFont(), QApplicationPrivate::setPalette_helper(), QApplication::setStyle(), QTextBlockFormat::setTabPositions(), QApplication::setWindowIcon(), QPatternist::LiteralSequence::staticType(), QTextOption::tabArray(), QDBusMessagePrivate::toDBusMessage(), QApplication::topLevelWidgets(), QStatePrivate::transitions(), QPatternist::CallTemplate::typeCheck(), QPatternist::Expression::typeCheckOperands(), QFontDialogPrivate::updateFamilies(), QBBScreen::updateHierarchy(), QFontDialogPrivate::updateSizes(), QSettingsPrivate::variantListToStringList(), QApplicationPrivate::x11_apply_settings(), QPatternist::MultiItemType::xdtSuperType(), QPatternist::MultiItemType::xdtTypeMatches(), QFbWindow::~QFbWindow(), and QTextCodecCleanup::~QTextCodecCleanup().

269 { return reinterpret_cast<Node *>(p.begin()); }

Definition: qdeclarativexmlhttprequest.cpp:224

Referenced by QItemSelectionModelPrivate::_q_layoutAboutToBeChanged(), QWindowsFileSystemWatcherEngine::addPaths(), QMacPasteboardMime::all(), QCopChannel::answer(), QDBusMarshaller::append(), QCoreApplication::applicationFilePath(), QSvgStyle::apply(), QApplicationPrivate::applyX11SpecificCommandLineArguments(), QPatternist::UserFunctionCallsite::bindVariables(), boundingRectOfFloatsInSelection(), QPatternist::CallTargetDescription::checkCallsiteCircularity(), QHttpPartPrivate::checkHeaderCreated(), QPatternist::checkVariableCircularity(), QStatePrivate::childStates(), QAbstractItemViewPrivate::clearOrRemove(), QPdfBaseEnginePrivate::closePrintDevice(), QPatternist::ExpressionSequence::compress(), QApplication::compressEvent(), QPatternist::VariableDeclaration::contains(), QHttpNetworkHeaderPrivate::contentLength(), QMacPasteboardMime::convertor(), QPatternist::FunctionFactoryCollection::createFunctionCall(), QVNCIntegration::createPlatformWindow(), debugVariantList(), QPatternist::Template::dependencies(), QPatternist::FunctionSignature::displayName(), QSvgSwitch::draw(), QSqlDatabase::drivers(), QDirModel::dropMimeData(), QFileSystemModel::dropMimeData(), QPatternist::GeneralComparison::evaluateEBV(), QPatternist::ConcatFN::evaluateSingleton(), QPatternist::ExpressionSequence::evaluateToSequenceReceiver(), QPatternist::FunctionCall::expectedOperandTypes(), familyList(), QNetworkAccessHttpBackend::fetchCacheMetaData(), QIconModeViewBase::filterStartDrag(), findChildObject(), QFontDatabase::findFont(), QMacPasteboardMime::flavorToMime(), fontFile(), QProcessEnvironmentPrivate::fromList(), QPatternist::FunctionFactoryCollection::functionSignatures(), generateSubObjectXml(), QFileInfoGatherer::getFileInfos(), QWindowSystemInterface::handleTouchEvent(), QNetworkRequest::hasRawHeader(), QHttpNetworkRequestPrivate::header(), QHttpNetworkHeaderPrivate::headerFieldValues(), QStatePrivate::historyStates(), QFont::insertSubstitutions(), QNetworkInterfaceManager::interfaceFromIndex(), QNetworkInterfaceManager::interfaceFromName(), QAxServerBase::internalCreate(), QPatternist::Expression::invokeOptimizers(), QPatternist::FunctionFactoryCollection::isAvailable(), QItemSelectionModel::isColumnSelected(), QItemSelectionModel::isRowSelected(), QCoreApplication::libraryPaths(), QNetworkAccessHttpBackend::loadFromCacheIfAllowed(), QDBusMessagePrivate::makeLocal(), QIdentityProxyModel::mapSelectionFromSource(), QIdentityProxyModel::mapSelectionToSource(), QIdentityProxyModel::match(), QDir::match(), mergeKeySets(), QDBusInterfacePrivate::metacall(), QPatternist::DistinctIterator::next(), QPatternist::UnlimitedContainer::operandsUnionType(), operator<<(), parseAnimateColorNode(), QAuthenticatorPrivate::parseHttpResponse(), QDBusAdaptorConnector::polish(), QSvgStructureNode::previousSiblingNode(), QPatternist::ExpressionSequence::properties(), QPatternist::Template::properties(), qDBusFindAdaptorConnector(), qDBusParametersForMethod(), QFileDialogPrivate::qt_mac_filedialog_filter_proc(), qt_mac_make_filters_list(), QUnixPrintWidgetPrivate::QUnixPrintWidgetPrivate(), QNetworkRequest::rawHeader(), QFactoryLoader::refreshAll(), registerFont(), QItemSelectionModelPrivate::remove(), QNetworkAccessHttpBackend::replyDownloadMetaData(), QSvgStyle::revert(), QNetworkAccessHttpBackend::sendCacheContents(), QWinSettingsPrivate::set(), QApplication::setFont(), QApplicationPrivate::setPalette_helper(), QApplication::setStyle(), QTextBlockFormat::setTabPositions(), QPrintDialogPrivate::setTabs(), QApplication::setWindowIcon(), QPatternist::LiteralSequence::staticType(), QTextOption::tabArray(), QDBusMessagePrivate::toDBusMessage(), QApplication::topLevelWidgets(), QStatePrivate::transitions(), QCoreApplication::translate(), QPatternist::CallTemplate::typeCheck(), QPatternist::Expression::typeCheckOperands(), QFontDialogPrivate::updateFamilies(), QBBScreen::updateHierarchy(), QFontDialogPrivate::updateSizes(), QSettingsPrivate::variantListToStringList(), QApplicationPrivate::x11_apply_settings(), QFbWindow::~QFbWindow(), and QTextCodecCleanup::~QTextCodecCleanup().

QListData p

Definition: qlist.h:118

QListData::begin

void ** begin() const

Definition: qlist.h:101

◆ constEnd()

template<typename T>

QList::const_iterator QList< T >::constEnd ( ) const

inline

Returns a const STL-style iterator pointing to the imaginary item after the last item in the list.

See also: constBegin(), end()

Definition at line 272 of file qlist.h.

272 { return reinterpret_cast<Node *>(p.end()); }

Definition: qdeclarativexmlhttprequest.cpp:224

QListData::end

void ** end() const

Definition: qlist.h:102

Referenced by QFileDialogPrivate::_q_autoCompleteFileName(), QHostInfoLookupManager::abortLookup(), QDeclarativeDataBlob::addDependency(), QJSDebugService::addEngine(), QDeclarativeEngineDebugService::addEngine(), QGraphicsSceneBspTreeIndexPrivate::addItem(), QGraphicsScenePrivate::addPopup(), QWidgetBackingStore::addStaticWidget(), QMacStylePrivate::addWidget(), QBBScreen::addWindow(), QmlJSDebugger::LiveSelectionTool::alreadySelected(), QMacStylePrivate::animatable(), QTextCodec::availableCodecs(), QTextCodec::availableMibs(), QNetworkReplyImplPrivate::backendNotify(), QDBusAbstractInterface::callWithArgumentList(), QDeclarativeDataBlob::cancelAllWaitingFor(), classIDL(), QFontEngineQPF::cleanUpAfterClientCrash(), QApplication::commitData(), compressHelper(), convertTypes(), QListWidget::dropEvent(), QTreeWidget::dropEvent(), QAbstractItemViewPrivate::droppingOnItself(), QMacStylePrivate::eventFilter(), findEncoding(), QPatternist::XsdSchemaHelper::foundSubstitutionGroupTransitive(), QHostInfoAgent::fromName(), QGLXContext::getProcAddress(), QGraphicsScenePrivate::grabKeyboard(), QGraphicsScenePrivate::grabMouse(), QEgl::hasExtension(), QWindowsStylePrivate::hasSeenAlt(), QMenuPrivate::hideMenu(), QPictureIO::inputFormats(), QTextTable::insertColumns(), QMdiAreaPrivate::internalRaise(), QScanThread::isKnownSsid(), QFontDatabase::loadXlfd(), QXlibMime::mimeAtomForFormat(), QAbstractButtonPrivate::moveFocus(), QVNCIntegration::moveToScreen(), QAudioDeviceInfo::nearestFormat(), QDeclarativePixmapReader::networkRequestDone(), QDeclarativeDataBlob::notifyAllWaitingOnMe(), QDeclarativeDataBlob::notifyComplete(), QDeclarativeEngineDebugService::objectCreated(), QPictureIO::outputFormats(), QNetworkManagerEngine::parseConnection(), QAuthenticatorPrivate::parseDigestAuthenticationChallenge(), QFontDatabase::pointSizes(), QTextDocumentLayoutPrivate::positionFloat(), QNetworkAccessHttpBackend::postRequest(), prototype(), q_hasEglExtension(), QGLXContext::QGLXContext(), QItemSelection::QItemSelection(), qt_grab_cursor(), MetaObjectGenerator::readEventInfo(), QStateMachinePrivate::registerEventTransition(), QAccessibleApplication::relationTo(), QAccessibleGroupBox::relationTo(), QDeclarativeEngineDebugService::remEngine(), QNetworkManagerEngine::removeAccessPoint(), QTextTable::removeColumns(), QBBIntegration::removeDisplay(), QJSDebugService::removeEngine(), QGraphicsSceneBspTreeIndexPrivate::removeItem(), QGraphicsScenePrivate::removeItemHelper(), QGraphicsScenePrivate::removePopup(), QTextTable::removeRows(), QPatternist::XsdSchemaResolver::resolveSimpleRestrictions(), QGraphicsAnchorLayoutPrivate::restoreSimplifiedAnchor(), QGraphicsAnchorLayoutPrivate::restoreSimplifiedGraph(), QmlJSDebugger::LiveSingleSelectionManipulator::select(), QmlJSDebugger::LiveRubberBandSelectionManipulator::select(), QTableViewPrivate::selectColumn(), QTableViewPrivate::selectRow(), QWin32PrintEngine::setProperty(), QmlJSDebugger::QDeclarativeViewInspectorPrivate::setSelectedItemsForTools(), QMessageBox::setStandardButtons(), QUrlModel::setUrl(), QFileDialogComboBox::showPopup(), QGraphicsAnchorLayoutPrivate::simplifyVertices(), QFontDatabase::smoothSizes(), QWindowsStylePrivate::startAnimation(), QSslSocketBackendPrivate::startHandshake(), QPatternist::XsdParticleChecker::subsumes(), QMdiAreaPrivate::subWindowList(), QMacPrintEnginePrivate::supportedResolutions(), QPatternist::XsdStateMachine< XsdSchemaToken::NodeName >::toDFA(), QmlJSDebugger::AbstractLiveEditTool::topSelectedItemIsMovable(), QDeclarativeTransitionManager::transition(), translateWSAError(), QGestureManager::unregisterGestureRecognizer(), QDesktopWidgetPrivate::updateScreenList(), MetaObjectGenerator::usertypeToString(), QMainWindowLayout::usesHIToolBar(), QHostInfoLookupManager::wasAborted(), QDeclarativeBehavior::write(), writingSystemForFont(), QFontDatabase::writingSystems(), and QX11Data::xdndMimeAtomForFormat().

QListData p

Definition: qlist.h:118

◆ contains()

template<typename T>

Q_OUTOFLINE_TEMPLATE QBool QList< T >::contains ( const T & value ) const

Returns true if the list contains an occurrence of value; otherwise returns false.

This function requires the value type to have an implementation of operator==().

See also: indexOf(), count()

Definition at line 880 of file qlist.h.

 {
     Node *b = reinterpret_cast<Node *>(p.begin());
     Node *i = reinterpret_cast<Node *>(p.end());
     while (i-- != b)
         if (i->t() == t)
             return QBool(true);
     return QBool(false);
 }

◆ count() [1/2]

template<typename T>

Q_OUTOFLINE_TEMPLATE int QList< T >::count ( const T & value ) const

Returns the number of occurrences of value in the list.

This function requires the value type to have an implementation of operator==().

See also: contains(), indexOf()

Definition at line 891 of file qlist.h.

 {
     int c = 0;
     Node *b = reinterpret_cast<Node *>(p.begin());
     Node *i = reinterpret_cast<Node *>(p.end());
     while (i-- != b)
         if (i->t() == t)
             ++c;
     return c;
 }

◆ count() [2/2]

template<typename T>

int QList< T >::count ( ) const

inline

Returns the number of items in the list.

This is effectively the same as size().

Definition at line 280 of file qlist.h.

280 { return p.size(); }

QListData p

Definition: qlist.h:118

int size() const

Definition: qlist.h:98

◆ detach()

template<typename T>

void QList< T >::detach ( )

inline

Warning: This function is not part of the public interface.

Definition at line 139 of file qlist.h.

139 { if (d->ref != 1) detach_helper(); }

QList::detach_helper

void detach_helper()

Definition: qlist.h:723

QListData::Data * d

Definition: qlist.h:118

QBasicAtomicInt ref

Definition: qlist.h:73

◆ detach_helper() [1/2]

template<typename T >

Q_OUTOFLINE_TEMPLATE void QList< T >::detach_helper ( int alloc )

private

Definition at line 706 of file qlist.h.

 {
     Node *n = reinterpret_cast<Node *>(p.begin());
     QListData::Data *x = p.detach(alloc);
     QT_TRY {
         node_copy(reinterpret_cast<Node *>(p.begin()), reinterpret_cast<Node *>(p.end()), n);
     } QT_CATCH(...) {
         qFree(d);
         d = x;
         QT_RETHROW;
     }
 
     if (!x->ref.deref())
         free(x);
 }

◆ detach_helper() [2/2]

template<typename T >

Q_OUTOFLINE_TEMPLATE void QList< T >::detach_helper ( )

private

Definition at line 723 of file qlist.h.

 {
     detach_helper(d->alloc);
 }

◆ detach_helper_grow()

template<typename T >

Q_OUTOFLINE_TEMPLATE QList< T >::Node * QList< T >::detach_helper_grow	(	int	i,
		int	n
	)

private

Definition at line 676 of file qlist.h.

 {
     Node *n = reinterpret_cast<Node *>(p.begin());
     QListData::Data *x = p.detach_grow(&i, c);
     QT_TRY {
         node_copy(reinterpret_cast<Node *>(p.begin()),
                   reinterpret_cast<Node *>(p.begin() + i), n);
     } QT_CATCH(...) {
         qFree(d);
         d = x;
         QT_RETHROW;
     }
     QT_TRY {
         node_copy(reinterpret_cast<Node *>(p.begin() + i + c),
                   reinterpret_cast<Node *>(p.end()), n + i);
     } QT_CATCH(...) {
         node_destruct(reinterpret_cast<Node *>(p.begin()),
                       reinterpret_cast<Node *>(p.begin() + i));
         qFree(d);
         d = x;
         QT_RETHROW;
     }
 
     if (!x->ref.deref())
         free(x);
 
     return reinterpret_cast<Node *>(p.begin() + i);
 }

◆ detachShared()

template<typename T>

void QList< T >::detachShared ( )

inline

This prevents needless mallocs, and makes QList more exception safe in case of cleanup work done in destructors on empty lists.

Warning: This function is not part of the public interface.

like detach(), but does nothing if we're shared_null.

Definition at line 141 of file qlist.h.

     {
         // The "this->" qualification is needed for GCCE.
         if (d->ref != 1 && this->d != &QListData::shared_null)
             detach_helper();
     }

◆ empty()

template<typename T>

bool QList< T >::empty ( ) const

inline

This function is provided for STL compatibility.

It is equivalent to isEmpty() and returns true if the list is empty.

Definition at line 304 of file qlist.h.

Referenced by QCoreApplication::applicationFilePath(), QMdi::MinOverlapPlacer::findBestPlacement(), QBenchmarkValgrindUtils::getNewestFileName(), QWSServer::mouseHandler(), QSslSocketBackendPrivate::startHandshake(), and QMenuBarPrivate::QWceMenuBarPrivate::~QWceMenuBarPrivate().

304 { return isEmpty(); }

Referenced by QItemSelectionModelPrivate::_q_columnsAboutToBeInserted(), QFileSystemModelPrivate::_q_directoryChanged(), QScriptDebuggerConsoleWidgetPrivate::_q_onCompletionTaskFinished(), QItemSelectionModelPrivate::_q_rowsAboutToBeInserted(), QGraphicsSceneBspTreeIndexPrivate::_q_updateSortCache(), QDeclarativeImportsPrivate::add(), QDeclarativeTimeLinePrivate::advance(), QCopChannel::answer(), QSyntaxHighlighterPrivate::applyFormatChanges(), QStateMachinePrivate::applyProperties(), QTextEngine::calculateTabWidth(), QWorkspace::cascade(), QRingBuffer< T >::clear(), QGraphicsSceneBspTreeIndexPrivate::climbTree(), QTreeViewPrivate::columnRanges(), QPatternist::UnlimitedContainer::compressOperands(), convertFlags(), QNetworkCookieJar::cookiesForUrl(), createInterfaces(), QCopChannel::detach(), QSvgG::draw(), QSvgTinyDocument::draw(), QSvgSwitch::draw(), QAbstractItemModel::encodeData(), QThreadPoolPrivate::enqueueTask(), QGraphicsItemPrivate::ensureSequentialSiblingIndex(), QGraphicsScenePrivate::ensureSequentialTopLevelSiblingIndexes(), QListModel::ensureSorted(), QTreeModel::ensureSorted(), QGraphicsScenePrivate::ensureSortedTopLevelItems(), QStateMachinePrivate::enterStates(), QStateMachinePrivate::exitStates(), fallbackFamilies(), findAllLibCrypto(), findAllLibSsl(), QMdi::MinOverlapPlacer::getCandidatePlacements(), QListModel::insert(), QGraphicsItemAnimationPrivate::insertUniquePair(), interfaceListing(), QSimplexConstraint::invert(), QAxScript::load(), QAxScriptManager::load(), QScript::QObjectData::mark(), QItemSelection::merge(), QDirModel::mimeData(), QFileSystemModel::mimeData(), QBBWindow::offset(), QHttpHeader::parse(), QWorkspacePrivate::place(), postProcess(), QDeclarativeBasePositioner::prePositioning(), QTDSDriver::primaryIndex(), QXmlSimpleReaderPrivate::processElementEmptyTag(), QDeclarativeDomObjectPrivate::properties(), qax_startServer(), qax_stopServer(), QAxConnection::QAxConnection(), QClassFactory::QClassFactory(), qDBusRemoveTimeout(), QDeclarativeImportDatabase::QDeclarativeImportDatabase(), qGetODBCVersion(), qSplitTableQualifier(), QtPrivate::QStringList_removeDuplicates(), QApplicationPrivate::qt_mac_apply_settings(), qt_mac_send_posted_gl_updates(), qt_mac_update_child_gl_widgets(), qt_mac_update_intersected_gl_widgets(), qt_wce_delete_action_list(), qt_win_extract_filter(), qt_win_filter(), qt_win_get_save_file_name(), MetaObjectGenerator::readClassInfo(), QHttpNetworkReplyPrivate::removeAutoDecompressHeader(), QWindowsFileSystemWatcherEngine::removePaths(), QCoreApplication::removePostedEvents(), QDeclarativeImportsPrivate::resolvedUri(), QSvgHandler::resolveGradients(), QAxScriptManager::scriptFileFilter(), QTreeViewPrivate::select(), QAbstractItemView::selectedIndexes(), QAxBase::setControl(), QBBWindow::setGeometry(), QHttpNetworkHeaderPrivate::setHeaderField(), QMacPasteboard::setMimeData(), QBBWindow::setScreen(), QSimplex::simplifyConstraints(), sm_setProperty(), QStringListModel::sort(), QFileSystemModelPrivate::sortChildren(), QGraphicsSceneBspTreeIndexPrivate::sortItems(), QThreadPoolPrivate::stealRunnable(), QTextBlockFormat::tabPositions(), MetaObjectGenerator::tryCache(), QPatternist::ExpressionSequence::typeCheck(), QTableModel::updateRowIndexes(), QBBWindow::updateVisibility(), QBBWindow::updateZorder(), QTextOdfWriter::writeAll(), QTextOdfWriter::writeBlockFormat(), writeTypesEnum(), QApplicationPrivate::x11_apply_settings(), QMenuBarPrivate::QMacMenuBarPrivate::~QMacMenuBarPrivate(), and QMenuPrivate::QMacMenuPrivate::~QMacMenuPrivate().

bool isEmpty() const

Returns true if the list contains no items; otherwise returns false.

Definition: qlist.h:152

◆ end() [1/2]

template<typename T>

QList::iterator QList< T >::end ( )

inline

Returns an STL-style iterator pointing to the imaginary item after the last item in the list.

See also: begin(), constEnd()

Definition at line 270 of file qlist.h.

270 { detach(); return reinterpret_cast<Node *>(p.end()); }

void detach()

Definition: qlist.h:139

Definition: qdeclarativexmlhttprequest.cpp:224

QListData::end

void ** end() const

Definition: qlist.h:102

QListData p

Definition: qlist.h:118

◆ end() [2/2]

template<typename T>

const_iterator QList< T >::end ( ) const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 271 of file qlist.h.

271 { return reinterpret_cast<Node *>(p.end()); }

Definition: qdeclarativexmlhttprequest.cpp:224

QListData::end

void ** end() const

Definition: qlist.h:102

QListData p

Definition: qlist.h:118

◆ endsWith()

template<typename T>

bool QList< T >::endsWith ( const T & value ) const

inline

Returns true if this list is not empty and its last item is equal to value; otherwise returns false.

Since: 4.5

See also: isEmpty(), contains()

Definition at line 289 of file qlist.h.

Referenced by QFSCompleter::splitPath().

289 { return !isEmpty() && last() == t; }

bool isEmpty() const

Returns true if the list contains no items; otherwise returns false.

Definition: qlist.h:152

Referenced by QItemSelectionModelPrivate::_q_columnsAboutToBeInserted(), QItemSelectionModelPrivate::_q_rowsAboutToBeInserted(), QCopChannel::answer(), QSyntaxHighlighterPrivate::applyFormatChanges(), QStateMachinePrivate::applyProperties(), QRingBuffer< T >::clear(), QCopChannel::detach(), fallbackFamilies(), QItemSelection::merge(), qDBusRemoveTimeout(), QtPrivate::QStringList_removeDuplicates(), rasterFallbacksMask(), QHttpNetworkReplyPrivate::removeAutoDecompressHeader(), QList< QPostEvent >::removeOne(), QCoreApplication::removePostedEvents(), QAbstractItemView::selectedIndexes(), QCoreApplicationPrivate::sendPostedEvents(), QHttpNetworkHeaderPrivate::setHeaderField(), QSimplex::simplifyConstraints(), and QThreadPoolPrivate::stealRunnable().

T & last()

Returns a reference to the last item in the list.

Definition: qlist.h:284

◆ erase() [1/2]

template<typename T >

QList< T >::iterator QList< T >::erase ( iterator pos )

inline

Removes the item associated with the iterator pos from the list, and returns an iterator to the next item in the list (which may be end()).

See also: insert(), removeAt()

Definition at line 464 of file qlist.h.

465 { node_destruct(it.i);

466 return reinterpret_cast<Node *>(p.erase(reinterpret_cast<void**>(it.i))); }

QListData::erase

void ** erase(void **xi)

Definition: qlist.cpp:408

Definition: qdeclarativexmlhttprequest.cpp:224

it

#define it(className, varName)

Definition: qbuiltintypes.cpp:95

QList::node_destruct

void node_destruct(Node *n)

Definition: qlist.h:386

QListData p

Definition: qlist.h:118

◆ erase() [2/2]

template<typename T>

QList::iterator QList< T >::erase	(	iterator	begin,
		iterator	end
	)

Removes all the items from begin up to (but not including) end.

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Returns an iterator to the same item that end referred to before the call.

◆ first() [1/2]

template<typename T>

T & QList< T >::first ( )

inline

Returns a reference to the first item in the list.

The list must not be empty. If the list can be empty, call isEmpty() before calling this function.

See also: last(), isEmpty()

Definition at line 282 of file qlist.h.

282 { Q_ASSERT(!isEmpty()); return *begin(); }

QList::begin

iterator begin()

Returns an STL-style iterator pointing to the first item in the list.

Definition: qlist.h:267

#define Q_ASSERT(cond)

Definition: qglobal.h:1823

bool isEmpty() const

Returns true if the list contains no items; otherwise returns false.

Definition: qlist.h:152

◆ first() [2/2]

template<typename T>

const T & QList< T >::first ( ) const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 283 of file qlist.h.

283 { Q_ASSERT(!isEmpty()); return at(0); }

#define Q_ASSERT(cond)

Definition: qglobal.h:1823

bool isEmpty() const

Returns true if the list contains no items; otherwise returns false.

Definition: qlist.h:152

QList::at

const T & at(int i) const

Returns the item at index position i in the list.

Definition: qlist.h:468

◆ free()

template<typename T >

Q_OUTOFLINE_TEMPLATE void QList< T >::free ( QListData::Data * d )

private

Definition at line 755 of file qlist.h.

 {
     node_destruct(reinterpret_cast<Node *>(data->array + data->begin),
                   reinterpret_cast<Node *>(data->array + data->end));
     qFree(data);
 }

◆ fromSet()

template<typename T>

QList< T > QList< T >::fromSet ( const QSet< T > & set )

static

Returns a QList object with the data contained in set.

The order of the elements in the QList is undefined.

Example:

QSet<int> set;
set << 20 << 30 << 40 << ... << 70;
QList<int> list = QList<int>::fromSet(set);
qSort(list);

See also: fromVector(), toSet(), QSet::toList(), qSort()

Definition at line 325 of file qset.h.

 {
     return set.toList();
 }

◆ fromStdList()

template<typename T>

QList< T > QList< T >::fromStdList ( const std::list< T > & list )

inlinestatic

Returns a QList object with the data contained in list.

The order of the elements in the QList is the same as in list.

Example:

std::list<double> stdlist;
list.push_back(1.2);
list.push_back(0.5);
list.push_back(3.14);
QList<double> list = QList<double>::fromStdList(stdlist);

See also: toStdList(), QVector::fromStdVector()

Definition at line 345 of file qlist.h.

346 { QList<T> tmp; qCopy(list.begin(), list.end(), std::back_inserter(tmp)); return tmp; }

qCopy

OutputIterator qCopy(InputIterator begin, InputIterator end, OutputIterator dest)

Definition: qalgorithms.h:79

QList

The QList class is a template class that provides lists.

Definition: qdatastream.h:62

◆ fromVector()

template<typename T>

QList< T > QList< T >::fromVector ( const QVector< T > & vector )

static

Returns a QList object with the data contained in vector.

Example:

QVector<double> vect;
vect << 20.0 << 30.0 << 40.0 << 50.0;
QList<double> list = QVector<T>::fromVector(vect);
// list: [20.0, 30.0, 40.0, 50.0]

See also: fromSet(), toVector(), QVector::toList()

Definition at line 795 of file qvector.h.

 {
     return vector.toList();
 }

◆ front() [1/2]

template<typename T>

T & QList< T >::front ( )

inline

This function is provided for STL compatibility.

It is equivalent to first(). The list must not be empty. If the list can be empty, call isEmpty() before calling this function.

Definition at line 298 of file qlist.h.

Referenced by QHeaderViewPrivate::resizeSections().

298 { return first(); }

T & first()

Returns a reference to the first item in the list.

Definition: qlist.h:282

◆ front() [2/2]

template<typename T>

const T & QList< T >::front ( ) const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 299 of file qlist.h.

299 { return first(); }

Referenced by QMenuBarPrivate::_q_actionHovered(), QFileDialogPrivate::_q_showHeader(), QMenuBarPrivate::actionRect(), QMenuPrivate::actionRect(), QMenuBarPrivate::QMacMenuBarPrivate::addAction(), QMenuBarPrivate::QWceMenuBarPrivate::addAction(), QMenuPrivate::QMacMenuPrivate::addAction(), QMenuPrivate::QWceMenuPrivate::addAction(), QFontSubset::addGlyph(), QMdiAreaPrivate::appendChild(), QAccessibleMenu::childAt(), QGraphicsScene::createItemGroup(), QGLWindowSurface::deleted(), QFutureInterfaceBasePrivate::disconnectOutputInterface(), QMainWindowLayout::dockWidgetArea(), QMdiAreaPrivate::emitWindowActivated(), QFontSubset::getReverseMap(), QMdiAreaPrivate::highlightNextSubWindow(), QDeclarativeCompiledData::indexForByteArray(), QDeclarativeCompiledData::indexForString(), QDeclarativeCompiledData::indexForUrl(), QScriptDebuggerLocalsModelPrivate::indexFromNode(), QAccessibleWidget::indexOfChild(), QAccessibleMenu::indexOfChild(), QAccessibleAbstractScrollArea::indexOfChild(), QAccessibleMenuBar::indexOfChild(), QAccessibleApplication::indexOfChild(), QAccessibleItemRow::indexOfChild(), QAccessibleWorkspace::indexOfChild(), QAccessibleMainWindow::indexOfChild(), QImageReaderPrivate::initHandler(), QFbScreen::lower(), QWidget::lower(), QUnicodeControlCharacterMenu::menuActionTriggered(), QAccessibleItemRow::navigate(), QMdiAreaPrivate::nextVisibleSubWindow(), QStringList::operator<<(), QVideoSurfaceFormatPrivate::operator==(), QMainWindowLayout::plug(), QObject::property(), QMainWindowLayout::qtmacToolbarDelegate(), QTreeWidgetItem::QTreeWidgetItem(), QFbScreen::raise(), QWidget::raise(), read_xpm_body(), QMdiAreaPrivate::rearrange(), QObjectCleanupHandler::remove(), QListModel::remove(), QTextFramePrivate::remove_me(), QGraphicsScenePrivate::removePopup(), QObjectPrivate::setParent_helper(), QObject::setProperty(), QMdiAreaPrivate::setViewMode(), QWidget::stackUnder(), QStateMachinePrivate::stateEntryLessThan(), QStateMachinePrivate::stateExitLessThan(), QWidgetPrivate::subtractOpaqueSiblings(), QGraphicsScenePrivate::ungrabMouse(), QUnifiedTimer::unregisterAnimation(), QMenuBarPrivate::wceDestroyMenuBar(), QmlJSDebugger::LiveSelectionTool::wheelEvent(), and QTreeWidgetItem::~QTreeWidgetItem().

T & first()

Returns a reference to the first item in the list.

Definition: qlist.h:282

◆ indexOf()

template<typename T>

Q_OUTOFLINE_TEMPLATE int QList< T >::indexOf	(	const T &	value,
		int	from = `0`
	)		const

Returns the index position of the first occurrence of value in the list, searching forward from index position from.

Returns -1 if no item matched.

Example:

QList<QString> list;
list << "A" << "B" << "C" << "B" << "A";
list.indexOf("B");          // returns 1
list.indexOf("B", 1);       // returns 1
list.indexOf("B", 2);       // returns 3
list.indexOf("X");          // returns -1

This function requires the value type to have an implementation of operator==().

Note that QList uses 0-based indexes, just like C++ arrays. Negative indexes are not supported with the exception of the value mentioned above.

See also: lastIndexOf(), contains()

Definition at line 847 of file qlist.h.

 {
     if (from < 0)
         from = qMax(from + p.size(), 0);
     if (from < p.size()) {
         Node *n = reinterpret_cast<Node *>(p.at(from -1));
         Node *e = reinterpret_cast<Node *>(p.end());
         while (++n != e)
             if (n->t() == t)
                 return int(n - reinterpret_cast<Node *>(p.begin()));
     }
     return -1;
 }

◆ insert() [1/2]

template<typename T>

void QList< T >::insert	(	int	i,
		const T &	value
	)

inline

Inserts value at index position i in the list.

If i is 0, the value is prepended to the list. If i is size(), the value is appended to the list.

Example:

QList<QString> list;
list << "alpha" << "beta" << "delta";
list.insert(2, "gamma");
// list: ["alpha", "beta", "gamma", "delta"]

See also: append(), prepend(), replace(), removeAt()

Definition at line 575 of file qlist.h.

Referenced by QObjectCleanupHandler::add(), QMenuBarPrivate::QMacMenuBarPrivate::addAction(), QMenuBarPrivate::QWceMenuBarPrivate::addAction(), QMenuPrivate::QMacMenuPrivate::addAction(), QMenuPrivate::QWceMenuPrivate::addAction(), QPollingFileSystemWatcherEngine::addPaths(), QTreeWidgetItem::clone(), QTextCodec::codecForName(), QNetworkCookieJar::cookiesForUrl(), QDeclarativeXmlQueryEngine::doSubQueryJob(), QThreadPoolPrivate::enqueueTask(), QListModel::ensureSorted(), QTreeModel::ensureSorted(), QApplicationPrivate::enterModal_sys(), find_translation(), QGLEngineSharedShaders::findProgramInCache(), QListModel::insert(), FlatListModel::insert(), NestedListModel::insert(), QTextDocumentPrivate::insert_frame(), QToolBarLayout::insertAction(), QTreeWidgetItem::insertChild(), QTreeWidgetItem::insertChildren(), QStandardItemPrivate::insertColumns(), FlatListModel::insertedNode(), QDockAreaLayoutInfo::insertGap(), QToolBarAreaLayoutInfo::insertGap(), QToolBarAreaLayoutInfo::insertItem(), QStringListModel::insertRows(), QListModel::insertRows(), QStandardItemPrivate::insertRows(), QTreeModel::insertRows(), QToolBarAreaLayoutInfo::insertToolBarBreak(), QNetworkManagerEngine::interfacePropertiesChanged(), QGraphicsItem::mouseReleaseEvent(), qt_try_modal(), QtWndProc(), QApplication::qwsSetCustomColors(), QTextFramePrivate::remove_me(), QFileSystemModel::setData(), QDockAreaLayoutInfo::split(), and QApplication::x11EventFilter().

 {
     if (d->ref != 1) {
         Node *n = detach_helper_grow(i, 1);
         QT_TRY {
             node_construct(n, t);
         } QT_CATCH(...) {
             p.remove(i);
             QT_RETHROW;
         }
     } else {
         if (QTypeInfo<T>::isLarge || QTypeInfo<T>::isStatic) {
             Node *n = reinterpret_cast<Node *>(p.insert(i));
             QT_TRY {
                 node_construct(n, t);
             } QT_CATCH(...) {
                 p.remove(i);
                 QT_RETHROW;
             }
         } else {
             Node *n, copy;
             node_construct(&copy, t); // t might be a reference to an object in the array
             QT_TRY {
                 n = reinterpret_cast<Node *>(p.insert(i));;
             } QT_CATCH(...) {
                 node_destruct(&copy);
                 QT_RETHROW;
             }
             *n = copy;
         }
     }
 }

◆ insert() [2/2]

template<typename T>

QList< T >::iterator QList< T >::insert	(	iterator	before,
		const T &	value
	)

inline

Inserts value in front of the item pointed to by the iterator before.

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Returns an iterator pointing at the inserted item. Note that the iterator passed to the function will be invalid after the call; the returned iterator should be used instead.

Definition at line 451 of file qlist.h.

 {
     int iBefore = int(before.i - reinterpret_cast<Node *>(p.begin()));
     Node *n = reinterpret_cast<Node *>(p.insert(iBefore));
     QT_TRY {
         node_construct(n, t);
     } QT_CATCH(...) {
         p.remove(iBefore);
         QT_RETHROW;
     }
     return n;
 }

◆ isDetached()

template<typename T>

bool QList< T >::isDetached ( ) const

inline

Warning: This function is not part of the public interface.

Definition at line 148 of file qlist.h.

148 { return d->ref == 1; }

QListData::Data * d

Definition: qlist.h:118

QBasicAtomicInt ref

Definition: qlist.h:73

◆ isEmpty()

template<typename T>

bool QList< T >::isEmpty ( ) const

inline

Returns true if the list contains no items; otherwise returns false.

See also: size()

Definition at line 152 of file qlist.h.

152 { return p.isEmpty(); }

QListData p

Definition: qlist.h:118

QListData::isEmpty

bool isEmpty() const

Definition: qlist.h:99

◆ isSharedWith()

template<typename T>

bool QList< T >::isSharedWith ( const QList< T > & other ) const

inline

Warning: This function is not part of the public interface.

Definition at line 150 of file qlist.h.

150 { return d == other.d; }

QListData::Data * d

Definition: qlist.h:118

◆ last() [1/2]

template<typename T>

T & QList< T >::last ( )

inline

Returns a reference to the last item in the list.

The list must not be empty. If the list can be empty, call isEmpty() before calling this function.

See also: first(), isEmpty()

Definition at line 284 of file qlist.h.

284 { Q_ASSERT(!isEmpty()); return *(--end()); }

#define Q_ASSERT(cond)

Definition: qglobal.h:1823

bool isEmpty() const

Returns true if the list contains no items; otherwise returns false.

Definition: qlist.h:152

QList::end

iterator end()

Returns an STL-style iterator pointing to the imaginary item after the last item in the list...

Definition: qlist.h:270

◆ last() [2/2]

template<typename T>

const T & QList< T >::last ( ) const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 285 of file qlist.h.

285 { Q_ASSERT(!isEmpty()); return at(count() - 1); }

#define Q_ASSERT(cond)

Definition: qglobal.h:1823

Referenced by QHostInfoLookupManager::abortLookup(), QSyntaxHighlighterPrivate::applyFormatChanges(), QByteDataBuffer::bufferCount(), QByteDataBuffer::canReadLine(), QDeclarativeCompiler::completeComponentBuild(), QmlJSDebugger::LiveSelectionTool::contextMenuElementHovered(), QmlJSDebugger::LiveSelectionTool::contextMenuElementSelected(), QNetworkCookieJar::cookiesForUrl(), QDeclarativeEnginePrivate::createQmlObject(), QFbScreen::doRedraw(), QFbScreen::generateRects(), QHttpNetworkRequestPrivate::header(), QmlJSDebugger::ZoomTool::nextZoomScale(), qt_win_get_save_file_name(), QVFbIntegration::QVFbIntegration(), QRingBuffer< T >::readPointerAtPosition(), QDeclarativeCompiler::rewriteBinding(), QmlJSDebugger::AbstractViewInspector::sendCurrentObjects(), sm_setProperty(), QDesktopWidgetPrivate::updateScreenList(), QmlJSDebugger::LiveSelectionTool::wheelEvent(), and QHostInfoLookupManager::work().

bool isEmpty() const

Returns true if the list contains no items; otherwise returns false.

Definition: qlist.h:152

QList::at

const T & at(int i) const

Returns the item at index position i in the list.

Definition: qlist.h:468

QList::count

int count() const

Returns the number of items in the list.

Definition: qlist.h:280

◆ lastIndexOf()

template<typename T>

Q_OUTOFLINE_TEMPLATE int QList< T >::lastIndexOf	(	const T &	value,
		int	from = `-1`
	)		const

Returns the index position of the last occurrence of value in the list, searching backward from index position from.

If from is -1 (the default), the search starts at the last item. Returns -1 if no item matched.

Example:

QList<QString> list;
list << "A" << "B" << "C" << "B" << "A";
list.lastIndexOf("B");      // returns 3
list.lastIndexOf("B", 3);   // returns 3
list.lastIndexOf("B", 2);   // returns 1
list.lastIndexOf("X");      // returns -1

This function requires the value type to have an implementation of operator==().

Note that QList uses 0-based indexes, just like C++ arrays. Negative indexes are not supported with the exception of the value mentioned above.

See also: indexOf()

Definition at line 862 of file qlist.h.

Referenced by QTreeModel::index(), QListModel::index(), QStringList::operator<<(), QRuntimeGraphicsSystem::removePixmapData(), QRuntimeGraphicsSystem::removeWindowSurface(), and QGraphicsScenePrivate::ungrabKeyboard().

 {
     if (from < 0)
         from += p.size();
     else if (from >= p.size())
         from = p.size()-1;
     if (from >= 0) {
         Node *b = reinterpret_cast<Node *>(p.begin());
         Node *n = reinterpret_cast<Node *>(p.at(from + 1));
         while (n-- != b) {
             if (n->t() == t)
                 return n - b;
         }
     }
     return -1;
 }

◆ length()

template<typename T>

int QList< T >::length ( ) const

inline

This function is identical to count().

Since: 4.5

See also: count()

Definition at line 281 of file qlist.h.

281 { return p.size(); } // Same as count()

QListData p

Definition: qlist.h:118

int size() const

Definition: qlist.h:98

◆ mid()

template<typename T >

Q_OUTOFLINE_TEMPLATE QList< T > QList< T >::mid	(	int	pos,
		int	length = `-1`
	)		const

Returns a list whose elements are copied from this list, starting at position pos.

If length is -1 (the default), all elements from pos are copied; otherwise length elements (or all remaining elements if there are less than length elements) are copied.

Definition at line 637 of file qlist.h.

 {
     if (alength < 0 || pos + alength > size())
         alength = size() - pos;
     if (pos == 0 && alength == size())
         return *this;
     QList<T> cpy;
     if (alength <= 0)
         return cpy;
     cpy.reserve(alength);
     cpy.d->end = alength;
     QT_TRY {
         cpy.node_copy(reinterpret_cast<Node *>(cpy.p.begin()),
                       reinterpret_cast<Node *>(cpy.p.end()),
                       reinterpret_cast<Node *>(p.begin() + pos));
     } QT_CATCH(...) {
         // restore the old end
         cpy.d->end = 0;
         QT_RETHROW;
     }
     return cpy;
 }

◆ move()

template<typename T >

void QList< T >::move	(	int	from,
		int	to
	)

inline

Moves the item at index position from to index position to.

Example:

QList<QString> list;
list << "A" << "B" << "C" << "D" << "E" << "F";
list.move(1, 4);
// list: ["A", "C", "D", "E", "B", "F"]

This is the same as insert({to}, takeAt({from})).This function assumes that both from and to are at least 0 but less than size(). To avoid failure, test that both from and to are at least 0 and less than size().

See also: swap(), insert(), takeAt()

Definition at line 628 of file qlist.h.

Referenced by QMdiAreaPrivate::_q_moveTab(), QMdiAreaPrivate::emitWindowActivated(), QGLEngineSharedShaders::findProgramInCache(), imageReadMimeFormats(), imageWriteMimeFormats(), QFbScreen::lower(), QWidget::lower(), QListModel::move(), QFbScreen::raise(), QWidget::raise(), QMdiAreaPrivate::rearrange(), QGraphicsItem::stackBefore(), and QWidget::stackUnder().

 {
     Q_ASSERT_X(from >= 0 && from < p.size() && to >= 0 && to < p.size(),
                "QList<T>::move", "index out of range");
     detach();
     p.move(from, to);
 }

◆ node_construct()

template<typename T>

Q_INLINE_TEMPLATE void QList< T >::node_construct	(	Node *	n,
		const T &	t
	)

private

Definition at line 370 of file qlist.h.

 {
     if (QTypeInfo<T>::isLarge || QTypeInfo<T>::isStatic) n->v = new T(t);
     else if (QTypeInfo<T>::isComplex) new (n) T(t);
 #if (defined(__GNUC__) || defined(__INTEL_COMPILER) || defined(__IBMCPP__)) && !defined(__OPTIMIZE__)
     // This violates pointer aliasing rules, but it is known to be safe (and silent)
     // in unoptimized GCC builds (-fno-strict-aliasing). The other compilers which
     // set the same define are assumed to be safe.
     else *reinterpret_cast<T*>(n) = t;
 #else
     // This is always safe, but penaltizes unoptimized builds a lot.
     else ::memcpy(n, &t, sizeof(T));
 #endif
 }

◆ node_copy()

template<typename T >

Q_INLINE_TEMPLATE void QList< T >::node_copy	(	Node *	from,
		Node *	to,
		Node *	src
	)

private

Definition at line 393 of file qlist.h.

Referenced by QList< QPostEvent >::mid().

 {
     Node *current = from;
     if (QTypeInfo<T>::isLarge || QTypeInfo<T>::isStatic) {
         QT_TRY {
             while(current != to) {
                 current->v = new T(*reinterpret_cast<T*>(src->v));
                 ++current;
                 ++src;
             }
         } QT_CATCH(...) {
             while (current-- != from)
                 delete reinterpret_cast<T*>(current->v);
             QT_RETHROW;
         }
 
     } else if (QTypeInfo<T>::isComplex) {
         QT_TRY {
             while(current != to) {
                 new (current) T(*reinterpret_cast<T*>(src));
                 ++current;
                 ++src;
             }
         } QT_CATCH(...) {
             while (current-- != from)
                 (reinterpret_cast<T*>(current))->~T();
             QT_RETHROW;
         }
     } else {
         if (src != from && to - from > 0)
             memcpy(from, src, (to - from) * sizeof(Node *));
     }
 }

◆ node_destruct() [1/2]

template<typename T >

Q_INLINE_TEMPLATE void QList< T >::node_destruct ( Node * n )

private

Definition at line 386 of file qlist.h.

 {
     if (QTypeInfo<T>::isLarge || QTypeInfo<T>::isStatic) delete reinterpret_cast<T*>(n->v);
     else if (QTypeInfo<T>::isComplex) reinterpret_cast<T*>(n)->~T();
 }

◆ node_destruct() [2/2]

template<typename T >

Q_INLINE_TEMPLATE void QList< T >::node_destruct	(	Node *	from,
		Node *	to
	)

private

Definition at line 428 of file qlist.h.

 {
     if (QTypeInfo<T>::isLarge || QTypeInfo<T>::isStatic)
         while(from != to) --to, delete reinterpret_cast<T*>(to->v);
     else if (QTypeInfo<T>::isComplex)
         while (from != to) --to, reinterpret_cast<T*>(to)->~T();
 }

◆ operator!=()

template<typename T>

bool QList< T >::operator!= ( const QList< T > & other ) const

inline

Returns true if other is not equal to this list; otherwise returns false.

Two lists are considered equal if they contain the same values in the same order.

This function requires the value type to have an implementation of operator==().

See also: operator==()

Definition at line 135 of file qlist.h.

135 { return !(*this == l); }

QFactoryLoader * l

Definition: qimagewriter.cpp:152

◆ operator+()

template<typename T>

QList< T > QList< T >::operator+ ( const QList< T > & other ) const

inline

Returns a list that contains all the items in this list followed by all the items in the other list.

See also: operator+=()

Definition at line 329 of file qlist.h.

330 { QList n = *this; n += l; return n; }

QFactoryLoader * l

Definition: qimagewriter.cpp:152

QList

The QList class is a template class that provides lists.

Definition: qdatastream.h:62

◆ operator+=() [1/2]

template<typename T>

Q_OUTOFLINE_TEMPLATE QList< T > & QList< T >::operator+= ( const QList< T > & other )

Appends the items of the other list to this list and returns a reference to this list.

See also: operator+(), append()

Definition at line 818 of file qlist.h.

 {
     if (!l.isEmpty()) {
         if (isEmpty()) {
             *this = l;
         } else {
             Node *n = (d->ref != 1)
                       ? detach_helper_grow(INT_MAX, l.size())
                       : reinterpret_cast<Node *>(p.append2(l.p));
             QT_TRY {
                 node_copy(n, reinterpret_cast<Node *>(p.end()),
                           reinterpret_cast<Node *>(l.p.begin()));
             } QT_CATCH(...) {
                 // restore the old end
                 d->end -= int(reinterpret_cast<Node *>(p.end()) - n);
                 QT_RETHROW;
             }
         }
     }
     return *this;
 }

◆ operator+=() [2/2]

template<typename T>

void QList< T >::operator+= ( const T & value )

inline

Appends value to the list.

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

See also: append(), operator<<()

Definition at line 331 of file qlist.h.

332 { append(t); return *this; }

QList::append

void append(const T &t)

Inserts value at the end of the list.

Definition: qlist.h:507

◆ operator<<() [1/2]

template<typename T>

QList< T > & QList< T >::operator<< ( const QList< T > & other )

inline

Appends the items of the other list to this list and returns a reference to this list.

See also: operator+=(), append()

Definition at line 335 of file qlist.h.

336 { *this += l; return *this; }

QFactoryLoader * l

Definition: qimagewriter.cpp:152

◆ operator<<() [2/2]

template<typename T>

void QList< T >::operator<< ( const T & value )

inline

Appends value to the list.

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 333 of file qlist.h.

Referenced by QItemSelection::QItemSelection().

334 { append(t); return *this; }

QList::append

void append(const T &t)

Inserts value at the end of the list.

Definition: qlist.h:507

◆ operator=()

template<typename T>

Q_INLINE_TEMPLATE QList< T > & QList< T >::operator= ( const QList< T > & l )

Assigns other to this list and returns a reference to this list.

Definition at line 437 of file qlist.h.

 {
     if (d != l.d) {
         QListData::Data *o = l.d;
         o->ref.ref();
         if (!d->ref.deref())
             free(d);
         d = o;
         if (!d->sharable)
             detach_helper();
     }
     return *this;
 }

◆ operator==()

template<typename T>

Q_OUTOFLINE_TEMPLATE bool QList< T >::operator== ( const QList< T > & other ) const

Returns true if other is equal to this list; otherwise returns false.

Two lists are considered equal if they contain the same values in the same order.

This function requires the value type to have an implementation of operator==().

See also: operator!=()

Definition at line 736 of file qlist.h.

 {
     if (p.size() != l.p.size())
         return false;
     if (d == l.d)
         return true;
     Node *i = reinterpret_cast<Node *>(p.end());
     Node *b = reinterpret_cast<Node *>(p.begin());
     Node *li = reinterpret_cast<Node *>(l.p.end());
     while (i != b) {
         --i; --li;
         if (!(i->t() == li->t()))
             return false;
     }
     return true;
 }

◆ operator[]() [1/2]

template<typename T >

const T & QList< T >::operator[] ( int i ) const

inline

Same as at().

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 472 of file qlist.h.

473 { Q_ASSERT_X(i >= 0 && i < p.size(), "QList<T>::operator[]", "index out of range");

474 return reinterpret_cast<Node *>(p.at(i))->t(); }

Definition: qdeclarativexmlhttprequest.cpp:224

QListData p

Definition: qlist.h:118

int size() const

Definition: qlist.h:98

void ** at(int i) const

Definition: qlist.h:100

Q_ASSERT_X

#define Q_ASSERT_X(cond, where, what)

Definition: qglobal.h:1837

◆ operator[]() [2/2]

template<typename T >

T & QList< T >::operator[] ( int i )

inline

Returns the item at index position i as a modifiable reference.

i must be a valid index position in the list (i.e., 0 <= i < size()).

This function is very fast (constant time).

See also: at(), value()

Definition at line 476 of file qlist.h.

477 { Q_ASSERT_X(i >= 0 && i < p.size(), "QList<T>::operator[]", "index out of range");

478 detach(); return reinterpret_cast<Node *>(p.at(i))->t(); }

void detach()

Definition: qlist.h:139

Definition: qdeclarativexmlhttprequest.cpp:224

QListData p

Definition: qlist.h:118

int size() const

Definition: qlist.h:98

Referenced by QAccessibleObjectPrivate::actionList(), QDeclarativeImportsPrivate::add(), QDeclarativeImportDatabase::addImportPath(), QWSServer::addKeyboardFilter(), QDeclarativeImportDatabase::addPluginPath(), QFbScreen::addWindow(), QTextCursorPrivate::adjustCursor(), allCombinations(), QMdiAreaPrivate::appendChild(), QDBusAbstractInterface::asyncCall(), QDBusAbstractInterface::call(), QScriptCompletionTaskPrivate::completeScriptExpression(), QGraphicsItem::deviceTransform(), QApplicationPrivate::dispatchEnterLeave(), QGraphicsScenePrivate::dispatchHoverEvent(), QDeclarativeTypeData::done(), QStateMachinePrivate::enterStates(), QScriptDebuggerCodeView::event(), QStateMachinePrivate::exitStates(), QIconLoader::findIconHelper(), QDockAreaLayoutInfo::findSeparator(), QDockAreaLayout::findSeparator(), findSnapshotIdsRecursively(), QHostInfoAgent::fromName(), QDockAreaLayoutInfo::gapIndex(), QMainWindowLayoutState::gapIndex(), QToolBarAreaLayout::gapIndex(), QDockAreaLayout::gapIndex(), QJSDebuggerAgentPrivate::getLocals(), QGuiPlatformPlugin::iconThemeSearchPaths(), QDirModel::index(), QMainWindowLayoutState::indexOf(), QDockAreaLayoutInfo::indexOf(), QToolBarAreaLayout::indexOf(), QDockAreaLayout::indexOf(), QDockAreaLayoutInfo::indexOfPlaceHolder(), QDockAreaLayout::indexOfPlaceHolder(), QObject::installEventFilter(), QCoreApplication::installTranslator(), QStateMachinePrivate::isPreempted(), QKeySequence::keyBindings(), QScreenDriverFactory::keys(), QLibraryPrivate::load_sys(), QFileSystemModelPrivate::node(), QDeclarativeDirParser::parse(), parseServerList(), QCompleter::pathFromIndex(), QByteDataBuffer::prepend(), QGraphicsItemPrivate::prependGraphicsTransform(), QFtpPI::processReply(), QAuServer::QAuServer(), QByteDataBuffer::read(), registerComponent(), QAxScriptManager::registerEngine(), QFileSystemModel::remove(), QDeclarativeImportDatabase::resolvePlugin(), QStateMachinePrivate::selectTransitions(), QWSServer::setKeyboardHandler(), QWSServer::setMouseHandler(), QFileDialogComboBox::showPopup(), QMdiAreaPrivate::subWindowList(), QWidgetBackingStore::sync(), QStandardItem::takeColumn(), QAbstractXmlForwardIterator< OutputType >::toReversed(), QRingBuffer< T >::ungetChar(), QGraphicsSceneInsertItemBspTreeVisitor::visit(), QGraphicsSceneFindItemBspTreeVisitor::visit(), QHostInfoLookupManager::work(), and QDeclarativeInfo::~QDeclarativeInfo().

void ** at(int i) const

Definition: qlist.h:100

Q_ASSERT_X

#define Q_ASSERT_X(cond, where, what)

Definition: qglobal.h:1837

◆ pop_back()

template<typename T>

void QList< T >::pop_back ( )

inline

This function is provided for STL compatibility.

It is equivalent to removeLast(). The list must not be empty. If the list can be empty, call isEmpty() before calling this function.

Definition at line 303 of file qlist.h.

303 { removeLast(); }

QList::removeLast

void removeLast()

Removes the last item in the list.

Definition: qlist.h:287

◆ pop_front()

template<typename T>

void QList< T >::pop_front ( )

inline

This function is provided for STL compatibility.

It is equivalent to removeFirst(). The list must not be empty. If the list can be empty, call isEmpty() before calling this function.

Definition at line 302 of file qlist.h.

Referenced by QDirModel::index(), QFileSystemModelPrivate::node(), QFtpPI::processReply(), QFileDialog::restoreState(), and QFtpPI::startNextCmd().

302 { removeFirst(); }

QList::removeFirst

void removeFirst()

Removes the first item in the list.

Definition: qlist.h:286

◆ prepend()

template<typename T>

void QList< T >::prepend ( const T & value )

inline

Inserts value at the beginning of the list.

Example:

QList<QString> list;
list.prepend("one");
list.prepend("two");
list.prepend("three");
// list: ["three", "two", "one"]

This is the same as list.insert(0, value).

This operation is usually very fast (constant time), because QList preallocates extra space on both sides of its internal buffer to allow for fast growth at both ends of the list.

See also: append(), insert()

Definition at line 541 of file qlist.h.

 {
     if (d->ref != 1) {
         Node *n = detach_helper_grow(0, 1);
         QT_TRY {
             node_construct(n, t);
         } QT_CATCH(...) {
             ++d->begin;
             QT_RETHROW;
         }
     } else {
         if (QTypeInfo<T>::isLarge || QTypeInfo<T>::isStatic) {
             Node *n = reinterpret_cast<Node *>(p.prepend());
             QT_TRY {
                 node_construct(n, t);
             } QT_CATCH(...) {
                 ++d->begin;
                 QT_RETHROW;
             }
         } else {
             Node *n, copy;
             node_construct(&copy, t); // t might be a reference to an object in the array
             QT_TRY {
                 n = reinterpret_cast<Node *>(p.prepend());;
             } QT_CATCH(...) {
                 node_destruct(&copy);
                 QT_RETHROW;
             }
             *n = copy;
         }
     }
 }

◆ push_back()

template<typename T>

void QList< T >::push_back ( const T & value )

inline

This function is provided for STL compatibility.

It is equivalent to append(value).

Definition at line 296 of file qlist.h.

Referenced by QBBScreen::addWindow(), operator>>(), qstring_to_xtp(), QBBWindow::raise(), QBBScreen::raiseWindow(), QBBInputContext::setComposingText(), QBBWindow::setParent(), QPixmapIconEngine::virtual_hook(), and QApplication::winFocus().

296 { append(t); }

QList::append

void append(const T &t)

Inserts value at the end of the list.

Definition: qlist.h:507

◆ push_front()

template<typename T>

void QList< T >::push_front ( const T & value )

inline

This function is provided for STL compatibility.

It is equivalent to prepend(value).

Definition at line 297 of file qlist.h.

Referenced by QBBScreen::addWindow(), QBBWindow::lower(), and QBBScreen::lowerWindow().

297 { prepend(t); }

QList::prepend

void prepend(const T &t)

Inserts value at the beginning of the list.

Definition: qlist.h:541

◆ removeAll()

template<typename T>

Q_OUTOFLINE_TEMPLATE int QList< T >::removeAll ( const T & value )

Removes all occurrences of value in the list and returns the number of entries removed.

Example:

QList<QString> list;
list << "sun" << "cloud" << "sun" << "rain";
list.removeAll("sun");
// list: ["cloud", "rain"]

This function requires the value type to have an implementation of operator==().

See also: removeOne(), removeAt(), takeAt(), replace()

Definition at line 770 of file qlist.h.

Referenced by QFileDialogPrivate::_q_autoCompleteFileName(), QFileSystemWatcherPrivate::_q_directoryChanged(), QFileSystemWatcherPrivate::_q_fileChanged(), QWidgetActionPrivate::_q_widgetDestroyed(), QApplicationPrivate::closePopup(), QGenericEngine::doRequestUpdate(), QMacStylePrivate::eventFilter(), QObject::installEventFilter(), QApplicationPrivate::leaveModal_sys(), QBBWindow::lower(), QAudioDeviceInfo::nearestFormat(), QCoreWlanEngine::networksChanged(), QNlaEngine::networksChanged(), QHttpHeader::parse(), QPatternist::XsdSchemaParser::parseRedefine(), qRemovePostRoutine(), qt_grab_cursor(), qt_try_modal(), QtWndProc(), QApplication::qwsSetCustomColors(), QBBWindow::raise(), QDeclarativeEngineDebugService::remEngine(), QItemSelectionModelPrivate::remove(), QGraphicsWidget::removeAction(), QMenuBarPrivate::QMacMenuBarPrivate::removeAction(), QMenuBarPrivate::QWceMenuBarPrivate::removeAction(), QMenuPrivate::QMacMenuPrivate::removeAction(), QMenuPrivate::QWceMenuPrivate::removeAction(), QWidget::removeAction(), QNetworkManagerEngine::removeConnection(), QBBIntegration::removeDisplay(), QJSDebugService::removeEngine(), QBBWindow::removeFromParent(), QImagePixmapCleanupHooks::removeImageHook(), QGraphicsScenePrivate::removeItemHelper(), QBBScreen::removeOverlayWindow(), QInotifyFileSystemWatcherEngine::removePaths(), QKqueueFileSystemWatcherEngine::removePaths(), QDnotifyFileSystemWatcherEngine::removePaths(), QWindowsFileSystemWatcherEngine::removePaths(), QFSEventsFileSystemWatcherEngine::removePaths(), QPollingFileSystemWatcherEngine::removePaths(), QImagePixmapCleanupHooks::removePixmapDataDestructionHook(), QImagePixmapCleanupHooks::removePixmapDataModificationHook(), QWidgetBackingStore::removeStaticWidget(), QMultiScreen::removeSubScreen(), QCoreApplication::removeTranslator(), QDeclarativeInspectorService::removeView(), QGraphicsScenePrivate::removeView(), QBBScreen::removeWindow(), QWindowsMimeList::removeWindowsMime(), QNativeWifiEngine::scanComplete(), QmlJSDebugger::LiveSingleSelectionManipulator::select(), QGraphicsTransformPrivate::setItem(), QWSServer::setKeyboardHandler(), QWSServer::setMouseHandler(), QMacStylePrivate::stopAnimate(), QWindowsStylePrivate::stopAnimation(), QWSWindow::stopEmbed(), QOCIDriver::tables(), QDBusConnectionPrivate::unregisterServiceNoLock(), QPSQLDriver::unsubscribeFromNotificationImplementation(), QGraphicsSceneRemoveItemBspTreeVisitor::visit(), QHostInfoLookupManager::work(), writingSystemForFont(), QApplication::x11EventFilter(), QAuServer::~QAuServer(), QGraphicsWidget::~QGraphicsWidget(), QWidget::~QWidget(), and QWSWindow::~QWSWindow().

 {
     int index = indexOf(_t);
     if (index == -1)
         return 0;
 
     const T t = _t;
     detach();
 
     Node *i = reinterpret_cast<Node *>(p.at(index));
     Node *e = reinterpret_cast<Node *>(p.end());
     Node *n = i;
     node_destruct(i);
     while (++i != e) {
         if (i->t() == t)
             node_destruct(i);
         else
             *n++ = *i;
     }
 
     int removedCount = e - n;
     d->end -= removedCount;
     return removedCount;
 }

◆ removeAt()

template<typename T >

void QList< T >::removeAt ( int i )

inline

Removes the item at index position i.

i must be a valid index position in the list (i.e., 0 <= i < size()).

See also: takeAt(), removeFirst(), removeLast(), removeOne()

Definition at line 480 of file qlist.h.

Referenced by QDeclarativeEngineDebugService::buildObjectList(), QRingBuffer< T >::chop(), QGLEngineSharedShaders::cleanupCustomStage(), QVNCScreen::connect(), QScriptDebuggerAgent::deleteBreakpoint(), QGLWindowSurface::deleted(), QFutureInterfaceBasePrivate::disconnectOutputInterface(), QIcdEngine::doRequestUpdate(), QItemSelectionModel::emitSelectionChanged(), QWindowsStyle::eventFilter(), QRingBuffer< T >::free(), handleRowsAttribute(), handleVisibleRowsAttribute(), QTextDocumentPrivate::insert_frame(), markFrames(), QItemSelection::merge(), QWidgetBackingStore::moveStaticWidgets(), QApplication::notify(), QPatternist::XsdSchemaParser::parseRedefine(), qExtractSecurityPolicyFromString(), QDeclarativeMetaType::qmlComponents(), QMultiInputContext::QMultiInputContext(), qt_painter_removePaintDevice(), QMainWindowLayout::qtmacToolbarDelegate(), QAbstractButtonPrivate::queryButtonList(), QWSPcMouseHandlerPrivate::QWSPcMouseHandlerPrivate(), QWSTslibMouseHandlerPrivate::QWSTslibMouseHandlerPrivate(), QObjectCleanupHandler::remove(), FlatListModel::remove(), QListModel::remove(), QDeclarativeTimeLine::remove(), QDockAreaLayoutInfo::remove(), NestedListModel::remove(), QToolBarAreaLayout::remove(), QTextFramePrivate::remove_me(), QGraphicsItemPrivate::removeChild(), removeInvisibleWidgetsFromList(), QMetaEnumBuilder::removeKey(), QFileSystemModelPrivate::removeNode(), QRuntimeGraphicsSystem::removePixmapData(), QStringListModel::removeRows(), QToolBarAreaLayoutInfo::removeToolBar(), QToolBarAreaLayoutInfo::removeToolBarBreak(), QFileSystemModelPrivate::removeVisibleFile(), QRuntimeGraphicsSystem::removeWindowSurface(), QPainter::restoreRedirected(), QAbstractItemViewPrivate::selectedDraggableIndexes(), QListView::selectedIndexes(), QItemSelectionModel::selection(), QFileSystemModel::setData(), QObjectPrivate::setParent_helper(), QVideoSurfaceFormat::setProperty(), QObject::setProperty(), QToolBarAreaLayout::takeAt(), QMacStylePrivate::timerEvent(), QDeclarativeTransitionManager::transition(), QAxServerBase::Unadvise(), QDockAreaLayoutInfo::unnest(), QUnifiedTimer::unregisterAnimation(), QGraphicsScenePrivate::unregisterTopLevelItem(), QMenuBarPrivate::wceDestroyMenuBar(), and QMenuPrivate::QMacMenuPrivate::~QMacMenuPrivate().

481 { if(i >= 0 && i < p.size()) { detach();

482 node_destruct(reinterpret_cast<Node *>(p.at(i))); p.remove(i); } }

void detach()

Definition: qlist.h:139

QList::node_destruct

void node_destruct(Node *n)

Definition: qlist.h:386

QListData p

Definition: qlist.h:118

QListData::remove

void remove(int i)

Definition: qlist.cpp:337

int size() const

Definition: qlist.h:98

void ** at(int i) const

Definition: qlist.h:100

◆ removeFirst()

template<typename T>

void QList< T >::removeFirst ( )

inline

Removes the first item in the list.

Calling this function is equivalent to calling removeAt(0). The list must not be empty. If the list can be empty, call isEmpty() before calling this function.

See also: removeAt(), takeFirst()

Definition at line 286 of file qlist.h.

Referenced by QPacketProtocolPrivate::bytesWritten(), QHttpPrivate::finishedWithSuccess(), QDBusUtil::isValidObjectPath(), QDialogButtonBoxPrivate::layoutButtons(), QPacketProtocol::read(), QRingBuffer< T >::read(), QHeaderViewPrivate::resizeSections(), QFSCompleter::splitPath(), QProcess::start(), QProcess::startDetached(), QThreadPoolPrivate::tryToStartMoreThreads(), and QFactoryLoader::updateDir().

286 { Q_ASSERT(!isEmpty()); erase(begin()); }

QList::begin

iterator begin()

Returns an STL-style iterator pointing to the first item in the list.

Definition: qlist.h:267

#define Q_ASSERT(cond)

Definition: qglobal.h:1823

bool isEmpty() const

Returns true if the list contains no items; otherwise returns false.

Definition: qlist.h:152

QList::erase

iterator erase(iterator pos)

Removes the item associated with the iterator pos from the list, and returns an iterator to the next ...

Definition: qlist.h:464

◆ removeLast()

template<typename T>

void QList< T >::removeLast ( )

inline

Removes the last item in the list.

Calling this function is equivalent to calling removeAt(size() - 1). The list must not be empty. If the list can be empty, call isEmpty() before calling this function.

See also: removeAt(), takeLast()

Definition at line 287 of file qlist.h.

Referenced by QFileDialogPrivate::_q_pathChanged(), QPatternist::NormalizeUnicodeFN::compress(), QGLEngineSharedShaders::findProgramInCache(), QScriptDebuggerAgent::functionExit(), QDBusConnection::objectRegisteredAt(), QHostAddress::parseSubnet(), QDBusConnection::registerObject(), and QFSCompleter::splitPath().

287 { Q_ASSERT(!isEmpty()); erase(--end()); }

#define Q_ASSERT(cond)

Definition: qglobal.h:1823

Referenced by QmlJSDebugger::QDeclarativeViewInspectorPrivate::_q_removeFromSelection(), QGLFramebufferObjectPool::acquire(), QScriptEnginePrivate::agentDeleted(), QIcdEngine::asyncUpdateConfigurationsSlot(), QDeclarativeDataBlob::cancelAllWaitingFor(), QIcdEngine::doRequestUpdate(), QmlJSDebugger::QDeclarativeViewInspectorPrivate::filterForSelection(), QNetworkManagerEngine::interfacePropertiesChanged(), QHostInfoLookupManager::lookupFinished(), QDeclarativeDataBlob::notifyComplete(), QDeclarativePackagePrivate::DataGuard::objectDestroyed(), QDeclarativeStatePrivate::OperationGuard::objectDestroyed(), Maemo::pendingCallFunction(), QNetworkAccessHttpBackend::postRequest(), QNetworkManagerEngine::removeAccessPoint(), QGraphicsItemPrivate::removeChild(), QConnmanEngine::removeConfiguration(), QGraphicsSceneBspTreeIndexPrivate::removeItem(), QGraphicsScenePrivate::removeItemHelper(), QFbScreen::removeWindow(), QThreadPoolThread::run(), QGraphicsItem::setFocusProxy(), QUnifiedTimer::unregisterAnimation(), QUnifiedTimer::unregisterRunningAnimation(), QWaylandClipboard::unregisterSelection(), QGraphicsScenePrivate::unregisterTopLevelItem(), QAbstractFileEngineHandler::~QAbstractFileEngineHandler(), QGtkStylePrivate::~QGtkStylePrivate(), and QSQLiteResult::~QSQLiteResult().

bool isEmpty() const

Returns true if the list contains no items; otherwise returns false.

Definition: qlist.h:152

QList::end

iterator end()

Returns an STL-style iterator pointing to the imaginary item after the last item in the list...

Definition: qlist.h:270

QList::erase

iterator erase(iterator pos)

Removes the item associated with the iterator pos from the list, and returns an iterator to the next ...

Definition: qlist.h:464

◆ removeOne()

template<typename T>

Q_OUTOFLINE_TEMPLATE bool QList< T >::removeOne ( const T & value )

Removes the first occurrence of value in the list and returns true on success; otherwise returns false.

Since: 4.4

Example:

QList<QString> list;
list << "sun" << "cloud" << "sun" << "rain";
list.removeOne("sun");
// list: ["cloud", ,"sun", "rain"]

This function requires the value type to have an implementation of operator==().

See also: removeAll(), removeAt(), takeAt(), replace()

Definition at line 796 of file qlist.h.

 {
     int index = indexOf(_t);
     if (index != -1) {
         removeAt(index);
         return true;
     }
     return false;
 }

◆ replace()

template<typename T>

void QList< T >::replace	(	int	i,
		const T &	value
	)

inline

Replaces the item at index position i with value.

i must be a valid index position in the list (i.e., 0 <= i < size()).

See also: operator[](), removeAt()

Definition at line 609 of file qlist.h.

Referenced by QFileDialogPrivate::_q_selectionChanged(), QMultiInputContext::changeSlave(), FlatListModel::get(), QStandardItemPrivate::insertColumns(), QStandardItemPrivate::insertRows(), QMultiInputContext::QMultiInputContext(), QStringListModel::setData(), QTreeModel::sortItems(), QPatternist::AddingAggregate::typeCheck(), and QPatternist::AvgFN::typeCheck().

 {
     Q_ASSERT_X(i >= 0 && i < p.size(), "QList<T>::replace", "index out of range");
     detach();
     reinterpret_cast<Node *>(p.at(i))->t() = t;
 }

◆ reserve()

template<typename T >

Q_OUTOFLINE_TEMPLATE void QList< T >::reserve ( int alloc )

Reserve space for alloc elements.

If alloc is smaller than the current size of the list, nothing will happen.

Use this function to avoid repetetive reallocation of QList's internal data if you can predict how many elements will be appended. Note that the reservation applies only to the internal pointer array.

Since: 4.7

Definition at line 496 of file qlist.h.

Referenced by QDeclarativeListModel::flatten(), QProcessEnvironmentPrivate::keys(), QMap< int, QFrameInfo >::keys(), QHash< QExplicitlySharedDataPointer, QHash >::keys(), macQuoteString(), QLocale::matchingLocales(), QList< QPostEvent >::mid(), operator>>(), QDeclarativeListModel::QDeclarativeListModel(), QTreeWidget::selectedItems(), QProcessEnvironmentPrivate::toList(), QSet< typename TokenLookupClass::NodeName >::toList(), QVector< QPoint >::toList(), QSystemLocalePrivate::uiLanguages(), QMap< int, QFrameInfo >::uniqueKeys(), QHash< QExplicitlySharedDataPointer, QHash >::uniqueKeys(), QMap< int, QFrameInfo >::values(), and QHash< QExplicitlySharedDataPointer, QHash >::values().

 {
     if (d->alloc < alloc) {
         if (d->ref != 1)
             detach_helper(alloc);
         else
             p.realloc(alloc);
     }
 }

◆ setSharable()

template<typename T>

void QList< T >::setSharable ( bool sharable )

inline

Warning: This function is not part of the public interface.

Definition at line 149 of file qlist.h.

149 { if (!sharable) detach(); d->sharable = sharable; }

QListData::Data::sharable

void detach()

Definition: qlist.h:139

uint sharable

Definition: qlist.h:75

QListData::Data * d

Definition: qlist.h:118

◆ size()

template<typename T>

int QList< T >::size ( ) const

inline

Returns the number of items in the list.

See also: isEmpty(), count()

Definition at line 137 of file qlist.h.

137 { return p.size(); }

QListData p

Definition: qlist.h:118

int size() const

Definition: qlist.h:98

◆ startsWith()

template<typename T>

bool QList< T >::startsWith ( const T & value ) const

inline

Returns true if this list is not empty and its first item is equal to value; otherwise returns false.

Since: 4.5

See also: isEmpty(), contains()

Definition at line 288 of file qlist.h.

288 { return !isEmpty() && first() == t; }

bool isEmpty() const

Returns true if the list contains no items; otherwise returns false.

Definition: qlist.h:152

T & first()

Returns a reference to the first item in the list.

Definition: qlist.h:282

◆ swap() [1/2]

template<typename T>

void QList< T >::swap ( QList< T > & other )

inline

Swaps list other with this list.

Since: 4.8

This operation is very fast and never fails.

Definition at line 129 of file qlist.h.

Referenced by QImageReaderPrivate::initHandler(), QCoreApplication::removePostedEvents(), and QQueue< QHostInfoRunnable *>::swap().

129 { qSwap(d, other.d); }

Referenced by QHostInfoLookupManager::abortLookup(), allCombinations(), QDialogButtonBox::clear(), QListModel::ensureSorted(), QTreeModel::ensureSorted(), QHttpNetworkConnectionPrivate::fillPipeline(), QDialogButtonBox::removeButton(), QGraphicsAnchorLayoutPrivate::removeCenterAnchors(), QGraphicsAnchorLayoutPrivate::removeCenterConstraints(), QScriptDebuggerLocalsModelPrivate::removeChild(), FlatListModel::removedNode(), QWSServer::removeKeyboardFilter(), QListModel::removeRows(), QTreeModel::removeRows(), QDockAreaLayoutInfo::restoreState(), QToolBarAreaLayout::restoreState(), QWindowsVistaStylePrivate::stopAnimation(), QListModel::take(), QToolBarLayout::takeAt(), QToolBarAreaLayout::takeAt(), QTreeWidgetItem::takeChild(), QWindowsVistaStylePrivate::timerEvent(), and QTreeWidgetItem::~QTreeWidgetItem().

QListData::Data * d

Definition: qlist.h:118

qSwap

void qSwap(T &value1, T &value2)

Definition: qglobal.h:2181

◆ swap() [2/2]

template<typename T>

void QList< T >::swap	(	int	i,
		int	j
	)

inline

Exchange the item at index position i with the item at index position j.

This function assumes that both i and j are at least 0 but less than size(). To avoid failure, test that both i and j are at least 0 and less than size().

Example:

QList<QString> list;
list << "A" << "B" << "C" << "D" << "E" << "F";
list.swap(1, 4);
// list: ["A", "E", "C", "D", "B", "F"]

See also: move()

Definition at line 617 of file qlist.h.

 {
     Q_ASSERT_X(i >= 0 && i < p.size() && j >= 0 && j < p.size(),
                 "QList<T>::swap", "index out of range");
     detach();
     void *t = d->array[d->begin + i];
     d->array[d->begin + i] = d->array[d->begin + j];
     d->array[d->begin + j] = t;
 }

◆ takeAt()

template<typename T >

T QList< T >::takeAt ( int i )

inline

Removes the item at index position i and returns it.

i must be a valid index position in the list (i.e., 0 <= i < size()).

If you don't use the return value, removeAt() is more efficient.

See also: removeAt(), takeFirst(), takeLast()

Definition at line 484 of file qlist.h.

 { Q_ASSERT_X(i >= 0 && i < p.size(), "QList<T>::take", "index out of range");
  detach(); Node *n = reinterpret_cast<Node *>(p.at(i)); T t = n->t(); node_destruct(n);
  p.remove(i); return t; }

◆ takeFirst()

template<typename T >

T QList< T >::takeFirst ( )

inline

Removes the first item in the list and returns it.

This is the same as takeAt(0). This function assumes the list is not empty. To avoid failure, call isEmpty() before calling this function.

This operation takes constant time.

If you don't use the return value, removeFirst() is more efficient.

See also: takeLast(), takeAt(), removeFirst()

Definition at line 489 of file qlist.h.

Referenced by QAbstractSocketPrivate::_q_connectToNextAddress(), QGraphicsSceneBspTreeIndexPrivate::_q_updateIndex(), QIcdEngine::asyncUpdateConfigurationsSlot(), cleanup_mimes(), QObjectCleanupHandler::clear(), QPlatformIntegrationFactory::create(), QDBusConnectionPrivate::customEvent(), QBoxLayoutPrivate::deleteAll(), QQueue< QHostInfoRunnable *>::dequeue(), QStateMachinePrivate::dequeueExternalEvent(), QStateMachinePrivate::dequeueInternalEvent(), QGenericEngine::doRequestUpdate(), QTreeWidget::dropEvent(), QPatternist::XsdStateMachine< XsdSchemaToken::NodeName >::epsilonClosure(), QDB2Result::exec(), findSnapshotIdsRecursively(), QHttpPrivate::finishedWithError(), QNetworkManagerEngine::interfacePropertiesChanged(), FAREnforcer::logAuthAttempt(), QScriptDebuggerPrivate::maybeStartNewJob(), QCoreWlanEngine::networksChanged(), QNlaEngine::networksChanged(), Maemo::prepareDBusCall(), qOraOutValue(), qt_call_post_routines(), qwsEventSourceDispatch(), QByteDataBuffer::read(), QRingBuffer< T >::read(), QWSDisplay::Data::readMore(), QWSClient::readMoreCommand(), QThreadPoolThread::run(), Maemo::IcdPrivate::scan(), QNativeWifiEngine::scanComplete(), QAction::setShortcuts(), QThreadPoolPrivate::startFrontRunnable(), QPatternist::XsdParticleChecker::subsumes(), QPatternist::XsdStateMachine< XsdSchemaToken::NodeName >::toDFA(), QThreadPoolPrivate::tryStart(), QNlaThread::updateConfigurations(), QGLWindowSurface::updateGeometry(), x11EventSourceDispatch(), QCoreWlanEngine::~QCoreWlanEngine(), QMenuPrivate::QMacMenuPrivate::~QMacMenuPrivate(), QScriptEnginePrivate::~QScriptEnginePrivate(), and QToolBarLayout::~QToolBarLayout().

490 { T t = first(); removeFirst(); return t; }

QList::removeFirst

void removeFirst()

Removes the first item in the list.

Definition: qlist.h:286

Referenced by QScriptEngine::availableExtensions(), QDeclarativeDataBlob::cancelAllWaitingFor(), QWSSignalHandler::clear(), QColumnViewPrivate::closeColumns(), convertPath(), QScriptDebuggerBackend::doPendingEvaluate(), QIconLoaderEngine::ensureLoaded(), QDeclarativePathView::itemsMoved(), QDeclarativeDataBlob::notifyAllWaitingOnMe(), QDeclarativeXmlQueryEngine::processJobs(), qWinProcessConfigRequests(), MetaObjectGenerator::readFuncsInfo(), QGraphicsScenePrivate::removePopup(), QApplicationPrivate::setScreenTransformation(), QGraphicsScenePrivate::ungrabKeyboard(), QGraphicsScenePrivate::ungrabMouse(), QDesktopWidgetPrivate::updateScreenList(), QApplication::winFocus(), and QIconLoaderEngine::~QIconLoaderEngine().

T & first()

Returns a reference to the first item in the list.

Definition: qlist.h:282

◆ takeLast()

template<typename T >

T QList< T >::takeLast ( )

inline

Removes the last item in the list and returns it.

This is the same as takeAt(size() - 1). This function assumes the list is not empty. To avoid failure, call isEmpty() before calling this function.

This operation takes constant time.

If you don't use the return value, removeLast() is more efficient.

See also: takeFirst(), takeAt(), removeLast()

Definition at line 492 of file qlist.h.

493 { T t = last(); removeLast(); return t; }

QList::removeLast

void removeLast()

Removes the last item in the list.

Definition: qlist.h:287