/**************************************************************************** ** ** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). ** Contact: http://www.qt-project.org/legal ** ** This file is part of the QtCore module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and Digia. For licensing terms and ** conditions see http://qt.digia.com/licensing. For further information ** use the contact form at http://qt.digia.com/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 2.1 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 2.1 requirements ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. ** ** In addition, as a special exception, Digia gives you certain additional ** rights. These rights are described in the Digia Qt LGPL Exception ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 3.0 as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL included in the ** packaging of this file. Please review the following information to ** ensure the GNU General Public License version 3.0 requirements will be ** met: http://www.gnu.org/copyleft/gpl.html. ** ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #ifndef QLINKEDLIST_H #define QLINKEDLIST_H #include #include #include #include QT_BEGIN_NAMESPACE struct Q_CORE_EXPORT QLinkedListData { QLinkedListData *n, *p; QtPrivate::RefCount ref; int size; uint sharable : 1; static const QLinkedListData shared_null; }; template struct QLinkedListNode { inline QLinkedListNode(const T &arg): t(arg) { } QLinkedListNode *n, *p; T t; }; template class QLinkedList { typedef QLinkedListNode Node; union { QLinkedListData *d; QLinkedListNode *e; }; public: inline QLinkedList() : d(const_cast(&QLinkedListData::shared_null)) { } inline QLinkedList(const QLinkedList &l) : d(l.d) { d->ref.ref(); if (!d->sharable) detach(); } ~QLinkedList(); QLinkedList &operator=(const QLinkedList &); #ifdef Q_COMPILER_RVALUE_REFS inline QLinkedList(QLinkedList &&other) : d(other.d) { other.d = const_cast(&QLinkedListData::shared_null); } inline QLinkedList &operator=(QLinkedList &&other) { qSwap(d, other.d); return *this; } #endif inline void swap(QLinkedList &other) { qSwap(d, other.d); } bool operator==(const QLinkedList &l) const; inline bool operator!=(const QLinkedList &l) const { return !(*this == l); } inline int size() const { return d->size; } inline void detach() { if (d->ref.isShared()) detach_helper(); } inline bool isDetached() const { return !d->ref.isShared(); } inline void setSharable(bool sharable) { if (!sharable) detach(); if (d != &QLinkedListData::shared_null) d->sharable = sharable; } inline bool isSharedWith(const QLinkedList &other) const { return d == other.d; } inline bool isEmpty() const { return d->size == 0; } void clear(); void append(const T &); void prepend(const T &); T takeFirst(); T takeLast(); int removeAll(const T &t); bool removeOne(const T &t); bool contains(const T &t) const; int count(const T &t) const; class const_iterator; class iterator { public: typedef std::bidirectional_iterator_tag iterator_category; typedef qptrdiff difference_type; typedef T value_type; typedef T *pointer; typedef T &reference; Node *i; inline iterator() : i(0) {} inline iterator(Node *n) : i(n) {} inline iterator(const iterator &o) : i(o.i) {} inline iterator &operator=(const iterator &o) { i = o.i; return *this; } inline T &operator*() const { return i->t; } inline T *operator->() const { return &i->t; } inline bool operator==(const iterator &o) const { return i == o.i; } inline bool operator!=(const iterator &o) const { return i != o.i; } inline bool operator==(const const_iterator &o) const { return i == o.i; } inline bool operator!=(const const_iterator &o) const { return i != o.i; } inline iterator &operator++() { i = i->n; return *this; } inline iterator operator++(int) { Node *n = i; i = i->n; return n; } inline iterator &operator--() { i = i->p; return *this; } inline iterator operator--(int) { Node *n = i; i = i->p; return n; } inline iterator operator+(int j) const { Node *n = i; if (j > 0) while (j--) n = n->n; else while (j++) n = n->p; return n; } inline iterator operator-(int j) const { return operator+(-j); } inline iterator &operator+=(int j) { return *this = *this + j; } inline iterator &operator-=(int j) { return *this = *this - j; } }; friend class iterator; class const_iterator { public: typedef std::bidirectional_iterator_tag iterator_category; typedef qptrdiff difference_type; typedef T value_type; typedef const T *pointer; typedef const T &reference; Node *i; inline const_iterator() : i(0) {} inline const_iterator(Node *n) : i(n) {} inline const_iterator(const const_iterator &o) : i(o.i){} inline const_iterator(iterator ci) : i(ci.i){} inline const_iterator &operator=(const const_iterator &o) { i = o.i; return *this; } inline const T &operator*() const { return i->t; } inline const T *operator->() const { return &i->t; } inline bool operator==(const const_iterator &o) const { return i == o.i; } inline bool operator!=(const const_iterator &o) const { return i != o.i; } inline const_iterator &operator++() { i = i->n; return *this; } inline const_iterator operator++(int) { Node *n = i; i = i->n; return n; } inline const_iterator &operator--() { i = i->p; return *this; } inline const_iterator operator--(int) { Node *n = i; i = i->p; return n; } inline const_iterator operator+(int j) const { Node *n = i; if (j > 0) while (j--) n = n->n; else while (j++) n = n->p; return n; } inline const_iterator operator-(int j) const { return operator+(-j); } inline const_iterator &operator+=(int j) { return *this = *this + j; } inline const_iterator &operator-=(int j) { return *this = *this - j; } }; friend class const_iterator; // stl style inline iterator begin() { detach(); return e->n; } inline const_iterator begin() const { return e->n; } inline const_iterator cbegin() const { return e->n; } inline const_iterator constBegin() const { return e->n; } inline iterator end() { detach(); return e; } inline const_iterator end() const { return e; } inline const_iterator cend() const { return e; } inline const_iterator constEnd() const { return e; } iterator insert(iterator before, const T &t); iterator erase(iterator pos); iterator erase(iterator first, iterator last); // more Qt typedef iterator Iterator; typedef const_iterator ConstIterator; inline int count() const { return d->size; } inline T& first() { Q_ASSERT(!isEmpty()); return *begin(); } inline const T& first() const { Q_ASSERT(!isEmpty()); return *begin(); } T& last() { Q_ASSERT(!isEmpty()); return *(--end()); } const T& last() const { Q_ASSERT(!isEmpty()); return *(--end()); } inline void removeFirst() { Q_ASSERT(!isEmpty()); erase(begin()); } inline void removeLast() { Q_ASSERT(!isEmpty()); erase(--end()); } inline bool startsWith(const T &t) const { return !isEmpty() && first() == t; } inline bool endsWith(const T &t) const { return !isEmpty() && last() == t; } // stl compatibility inline void push_back(const T &t) { append(t); } inline void push_front(const T &t) { prepend(t); } inline T& front() { return first(); } inline const T& front() const { return first(); } inline T& back() { return last(); } inline const T& back() const { return last(); } inline void pop_front() { removeFirst(); } inline void pop_back() { removeLast(); } inline bool empty() const { return isEmpty(); } typedef int size_type; typedef T value_type; typedef value_type *pointer; typedef const value_type *const_pointer; typedef value_type &reference; typedef const value_type &const_reference; typedef qptrdiff difference_type; static inline QLinkedList fromStdList(const std::list &list) { QLinkedList tmp; qCopy(list.begin(), list.end(), std::back_inserter(tmp)); return tmp; } inline std::list toStdList() const { std::list tmp; qCopy(constBegin(), constEnd(), std::back_inserter(tmp)); return tmp; } // comfort QLinkedList &operator+=(const QLinkedList &l); QLinkedList operator+(const QLinkedList &l) const; inline QLinkedList &operator+=(const T &t) { append(t); return *this; } inline QLinkedList &operator<< (const T &t) { append(t); return *this; } inline QLinkedList &operator<<(const QLinkedList &l) { *this += l; return *this; } private: void detach_helper(); void freeData(QLinkedListData*); }; template inline QLinkedList::~QLinkedList() { if (!d->ref.deref()) freeData(d); } template void QLinkedList::detach_helper() { union { QLinkedListData *d; Node *e; } x; x.d = new QLinkedListData; x.d->ref.initializeOwned(); x.d->size = d->size; x.d->sharable = true; Node *original = e->n; Node *copy = x.e; while (original != e) { QT_TRY { copy->n = new Node(original->t); copy->n->p = copy; original = original->n; copy = copy->n; } QT_CATCH(...) { copy->n = x.e; Q_ASSERT(!x.d->ref.deref()); // Don't trigger assert in free freeData(x.d); QT_RETHROW; } } copy->n = x.e; x.e->p = copy; if (!d->ref.deref()) freeData(d); d = x.d; } template void QLinkedList::freeData(QLinkedListData *x) { Node *y = reinterpret_cast(x); Node *i = y->n; Q_ASSERT(x->ref.atomic.load() == 0); while (i != y) { Node *n = i; i = i->n; delete n; } delete x; } template void QLinkedList::clear() { *this = QLinkedList(); } template QLinkedList &QLinkedList::operator=(const QLinkedList &l) { if (d != l.d) { QLinkedListData *o = l.d; o->ref.ref(); if (!d->ref.deref()) freeData(d); d = o; if (!d->sharable) detach_helper(); } return *this; } template bool QLinkedList::operator== (const QLinkedList &l) const { if (d->size != l.d->size) return false; if (e == l.e) return true; Node *i = e->n; Node *il = l.e->n; while (i != e) { if (! (i->t == il->t)) return false; i = i->n; il = il->n; } return true; } template void QLinkedList::append(const T &t) { detach(); Node *i = new Node(t); i->n = e; i->p = e->p; i->p->n = i; e->p = i; d->size++; } template void QLinkedList::prepend(const T &t) { detach(); Node *i = new Node(t); i->n = e->n; i->p = e; i->n->p = i; e->n = i; d->size++; } template int QLinkedList::removeAll(const T &_t) { detach(); const T t = _t; Node *i = e->n; int c = 0; while (i != e) { if (i->t == t) { Node *n = i; i->n->p = i->p; i->p->n = i->n; i = i->n; delete n; c++; } else { i = i->n; } } d->size-=c; return c; } template bool QLinkedList::removeOne(const T &_t) { detach(); iterator it = qFind(begin(), end(), _t); if (it != end()) { erase(it); return true; } return false; } template inline T QLinkedList::takeFirst() { T t = first(); removeFirst(); return t; } template inline T QLinkedList::takeLast() { T t = last(); removeLast(); return t; } template bool QLinkedList::contains(const T &t) const { Node *i = e; while ((i = i->n) != e) if (i->t == t) return true; return false; } template int QLinkedList::count(const T &t) const { Node *i = e; int c = 0; while ((i = i->n) != e) if (i->t == t) c++; return c; } template typename QLinkedList::iterator QLinkedList::insert(iterator before, const T &t) { Node *i = before.i; Node *m = new Node(t); m->n = i; m->p = i->p; m->p->n = m; i->p = m; d->size++; return m; } template typename QLinkedList::iterator QLinkedList::erase(typename QLinkedList::iterator afirst, typename QLinkedList::iterator alast) { while (afirst != alast) erase(afirst++); return alast; } template typename QLinkedList::iterator QLinkedList::erase(iterator pos) { detach(); Node *i = pos.i; if (i != e) { Node *n = i; i->n->p = i->p; i->p->n = i->n; i = i->n; delete n; d->size--; } return i; } template QLinkedList &QLinkedList::operator+=(const QLinkedList &l) { detach(); int n = l.d->size; d->size += n; Node *original = l.e->n; while (n--) { QT_TRY { Node *copy = new Node(original->t); original = original->n; copy->n = e; copy->p = e->p; copy->p->n = copy; e->p = copy; } QT_CATCH(...) { // restore the original list while (n++size) removeLast(); QT_RETHROW; } } return *this; } template QLinkedList QLinkedList::operator+(const QLinkedList &l) const { QLinkedList n = *this; n += l; return n; } Q_DECLARE_SEQUENTIAL_ITERATOR(LinkedList) Q_DECLARE_MUTABLE_SEQUENTIAL_ITERATOR(LinkedList) QT_END_NAMESPACE #endif // QLINKEDLIST_H