/**************************************************************************** ** ** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies). ** Contact: http://www.qt-project.org/ ** ** This file is part of the QtCore module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** GNU Lesser General Public License Usage ** 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, Nokia gives you certain additional ** rights. These rights are described in the Nokia 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. ** ** Other Usage ** Alternatively, this file may be used in accordance with the terms and ** conditions contained in a signed written agreement between you and Nokia. ** ** ** ** ** ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #ifndef QVECTOR_H #define QVECTOR_H #include #include #include #include #ifndef QT_NO_STL #include #include #endif #include #include #ifdef Q_COMPILER_INITIALIZER_LISTS #include #endif QT_BEGIN_HEADER QT_BEGIN_NAMESPACE struct Q_CORE_EXPORT QVectorData { QtPrivate::RefCount ref; int alloc; int size; #if defined(Q_PROCESSOR_SPARC) && defined(Q_CC_GNU) && defined(__LP64__) && defined(QT_BOOTSTRAPPED) // workaround for bug in gcc 3.4.2 uint sharable; uint capacity; uint reserved; #else uint sharable : 1; uint capacity : 1; uint reserved : 30; #endif static const QVectorData shared_null; // ### Qt 5: rename to 'allocate()'. The current name causes problems for // some debugges when the QVector is member of a class within an unnamed namespace. // ### Qt 5: can be removed completely. (Ralf) static QVectorData *malloc(int sizeofTypedData, int size, int sizeofT, QVectorData *init); static QVectorData *allocate(int size, int alignment); static QVectorData *reallocate(QVectorData *old, int newsize, int oldsize, int alignment); static void free(QVectorData *data, int alignment); static int grow(int sizeofTypedData, int size, int sizeofT, bool excessive); }; template struct QVectorTypedData : private QVectorData { // private inheritance as we must not access QVectorData member thought QVectorTypedData // as this would break strict aliasing rules. (in the case of shared_null) T array[1]; static inline void free(QVectorTypedData *x, int alignment) { QVectorData::free(static_cast(x), alignment); } }; class QRegion; template class QVector { typedef QVectorTypedData Data; union { QVectorData *d; #if defined(Q_CC_SUN) && (__SUNPRO_CC <= 0x550) QVectorTypedData *p; #else Data *p; #endif }; public: // ### Qt 5: Consider making QVector non-shared to get at least one // "really fast" container. See tests/benchmarks/corelib/tools/qvector/ inline QVector() : d(const_cast(&QVectorData::shared_null)) { } explicit QVector(int size); QVector(int size, const T &t); inline QVector(const QVector &v) : d(v.d) { d->ref.ref(); if (!d->sharable) detach_helper(); } inline ~QVector() { if (!d) return; if (!d->ref.deref()) free(p); } QVector &operator=(const QVector &v); #ifdef Q_COMPILER_RVALUE_REFS inline QVector operator=(QVector &&other) { qSwap(p, other.p); return *this; } #endif inline void swap(QVector &other) { qSwap(d, other.d); } #ifdef Q_COMPILER_INITIALIZER_LISTS inline QVector(std::initializer_list args); #endif bool operator==(const QVector &v) const; inline bool operator!=(const QVector &v) const { return !(*this == v); } inline int size() const { return d->size; } inline bool isEmpty() const { return d->size == 0; } void resize(int size); inline int capacity() const { return d->alloc; } void reserve(int size); inline void squeeze() { realloc(d->size, d->size); d->capacity = 0; } inline void detach() { if (d->ref != 1) detach_helper(); } inline bool isDetached() const { return d->ref == 1; } inline void setSharable(bool sharable) { if (!sharable) detach(); if (d != &QVectorData::shared_null) d->sharable = sharable; } inline bool isSharedWith(const QVector &other) const { return d == other.d; } inline T *data() { detach(); return p->array; } inline const T *data() const { return p->array; } inline const T *constData() const { return p->array; } void clear(); const T &at(int i) const; T &operator[](int i); const T &operator[](int i) const; void append(const T &t); void prepend(const T &t); void insert(int i, const T &t); void insert(int i, int n, const T &t); void replace(int i, const T &t); void remove(int i); void remove(int i, int n); QVector &fill(const T &t, int size = -1); int indexOf(const T &t, int from = 0) const; int lastIndexOf(const T &t, int from = -1) const; bool contains(const T &t) const; int count(const T &t) const; #ifdef QT_STRICT_ITERATORS class iterator { public: T *i; typedef std::random_access_iterator_tag iterator_category; typedef qptrdiff difference_type; typedef T value_type; typedef T *pointer; typedef T &reference; inline iterator() : i(0) {} inline iterator(T *n) : i(n) {} inline iterator(const iterator &o): i(o.i){} inline T &operator*() const { return *i; } inline T *operator->() const { return i; } inline T &operator[](int j) const { return *(i + j); } 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 iterator& other) const { return i < other.i; } inline bool operator<=(const iterator& other) const { return i <= other.i; } inline bool operator>(const iterator& other) const { return i > other.i; } inline bool operator>=(const iterator& other) const { return i >= other.i; } inline iterator &operator++() { ++i; return *this; } inline iterator operator++(int) { T *n = i; ++i; return n; } inline iterator &operator--() { i--; return *this; } inline iterator operator--(int) { T *n = i; i--; return n; } inline iterator &operator+=(int j) { i+=j; return *this; } inline iterator &operator-=(int j) { i-=j; return *this; } inline iterator operator+(int j) const { return iterator(i+j); } inline iterator operator-(int j) const { return iterator(i-j); } inline int operator-(iterator j) const { return i - j.i; } }; friend class iterator; class const_iterator { public: T *i; typedef std::random_access_iterator_tag iterator_category; typedef qptrdiff difference_type; typedef T value_type; typedef const T *pointer; typedef const T &reference; inline const_iterator() : i(0) {} inline const_iterator(T *n) : i(n) {} inline const_iterator(const const_iterator &o): i(o.i) {} inline explicit const_iterator(const iterator &o): i(o.i) {} inline const T &operator*() const { return *i; } inline const T *operator->() const { return i; } inline const T &operator[](int j) const { return *(i + j); } 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 bool operator<(const const_iterator& other) const { return i < other.i; } inline bool operator<=(const const_iterator& other) const { return i <= other.i; } inline bool operator>(const const_iterator& other) const { return i > other.i; } inline bool operator>=(const const_iterator& other) const { return i >= other.i; } inline const_iterator &operator++() { ++i; return *this; } inline const_iterator operator++(int) { T *n = i; ++i; return n; } inline const_iterator &operator--() { i--; return *this; } inline const_iterator operator--(int) { T *n = i; i--; return n; } inline const_iterator &operator+=(int j) { i+=j; return *this; } inline const_iterator &operator-=(int j) { i-=j; return *this; } inline const_iterator operator+(int j) const { return const_iterator(i+j); } inline const_iterator operator-(int j) const { return const_iterator(i-j); } inline int operator-(const_iterator j) const { return i - j.i; } }; friend class const_iterator; #else // STL-style typedef T* iterator; typedef const T* const_iterator; #endif inline iterator begin() { detach(); return p->array; } inline const_iterator begin() const { return p->array; } inline const_iterator constBegin() const { return p->array; } inline iterator end() { detach(); return p->array + d->size; } inline const_iterator end() const { return p->array + d->size; } inline const_iterator constEnd() const { return p->array + d->size; } iterator insert(iterator before, int n, const T &x); inline iterator insert(iterator before, const T &x) { return insert(before, 1, x); } iterator erase(iterator begin, iterator end); inline iterator erase(iterator pos) { return erase(pos, pos+1); } // more Qt 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(); } inline T& last() { Q_ASSERT(!isEmpty()); return *(end()-1); } inline const T &last() const { Q_ASSERT(!isEmpty()); return *(end()-1); } inline bool startsWith(const T &t) const { return !isEmpty() && first() == t; } inline bool endsWith(const T &t) const { return !isEmpty() && last() == t; } QVector mid(int pos, int length = -1) const; T value(int i) const; T value(int i, const T &defaultValue) const; // STL compatibility 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; typedef iterator Iterator; typedef const_iterator ConstIterator; typedef int size_type; inline void push_back(const T &t) { append(t); } inline void push_front(const T &t) { prepend(t); } void pop_back() { Q_ASSERT(!isEmpty()); erase(end()-1); } void pop_front() { Q_ASSERT(!isEmpty()); erase(begin()); } inline bool empty() const { return d->size == 0; } inline T& front() { return first(); } inline const_reference front() const { return first(); } inline reference back() { return last(); } inline const_reference back() const { return last(); } // comfort QVector &operator+=(const QVector &l); inline QVector operator+(const QVector &l) const { QVector n = *this; n += l; return n; } inline QVector &operator+=(const T &t) { append(t); return *this; } inline QVector &operator<< (const T &t) { append(t); return *this; } inline QVector &operator<<(const QVector &l) { *this += l; return *this; } QList toList() const; static QVector fromList(const QList &list); #ifndef QT_NO_STL static inline QVector fromStdVector(const std::vector &vector) { QVector tmp; tmp.reserve(int(vector.size())); qCopy(vector.begin(), vector.end(), std::back_inserter(tmp)); return tmp; } inline std::vector toStdVector() const { std::vector tmp; tmp.reserve(size()); qCopy(constBegin(), constEnd(), std::back_inserter(tmp)); return tmp; } #endif private: friend class QRegion; // Optimization for QRegion::rects() void detach_helper(); QVectorData *malloc(int alloc); void realloc(int size, int alloc); void free(Data *d); int sizeOfTypedData() { // this is more or less the same as sizeof(Data), except that it doesn't // count the padding at the end return reinterpret_cast(&(reinterpret_cast(this))->array[1]) - reinterpret_cast(this); } inline int alignOfTypedData() const { #ifdef Q_ALIGNOF return qMax(sizeof(void*), Q_ALIGNOF(Data)); #else return 0; #endif } }; template void QVector::detach_helper() { realloc(d->size, d->alloc); } template void QVector::reserve(int asize) { if (asize > d->alloc) realloc(d->size, asize); if (d->ref == 1) d->capacity = 1; } template void QVector::resize(int asize) { realloc(asize, (asize > d->alloc || (!d->capacity && asize < d->size && asize < (d->alloc >> 1))) ? QVectorData::grow(sizeOfTypedData(), asize, sizeof(T), QTypeInfo::isStatic) : d->alloc); } template inline void QVector::clear() { *this = QVector(); } template inline const T &QVector::at(int i) const { Q_ASSERT_X(i >= 0 && i < d->size, "QVector::at", "index out of range"); return p->array[i]; } template inline const T &QVector::operator[](int i) const { Q_ASSERT_X(i >= 0 && i < d->size, "QVector::operator[]", "index out of range"); return p->array[i]; } template inline T &QVector::operator[](int i) { Q_ASSERT_X(i >= 0 && i < d->size, "QVector::operator[]", "index out of range"); return data()[i]; } template inline void QVector::insert(int i, const T &t) { Q_ASSERT_X(i >= 0 && i <= d->size, "QVector::insert", "index out of range"); insert(begin() + i, 1, t); } template inline void QVector::insert(int i, int n, const T &t) { Q_ASSERT_X(i >= 0 && i <= d->size, "QVector::insert", "index out of range"); insert(begin() + i, n, t); } template inline void QVector::remove(int i, int n) { Q_ASSERT_X(i >= 0 && n >= 0 && i + n <= d->size, "QVector::remove", "index out of range"); erase(begin() + i, begin() + i + n); } template inline void QVector::remove(int i) { Q_ASSERT_X(i >= 0 && i < d->size, "QVector::remove", "index out of range"); erase(begin() + i, begin() + i + 1); } template inline void QVector::prepend(const T &t) { insert(begin(), 1, t); } template inline void QVector::replace(int i, const T &t) { Q_ASSERT_X(i >= 0 && i < d->size, "QVector::replace", "index out of range"); const T copy(t); data()[i] = copy; } template QVector &QVector::operator=(const QVector &v) { QVectorData *o = v.d; o->ref.ref(); if (!d->ref.deref()) free(p); d = o; if (!d->sharable) detach_helper(); return *this; } template inline QVectorData *QVector::malloc(int aalloc) { QVectorData *vectordata = QVectorData::allocate(sizeOfTypedData() + (aalloc - 1) * sizeof(T), alignOfTypedData()); Q_CHECK_PTR(vectordata); return vectordata; } template QVector::QVector(int asize) { d = malloc(asize); d->ref = 1; d->alloc = d->size = asize; d->sharable = true; d->capacity = false; if (QTypeInfo::isComplex) { T* b = p->array; T* i = p->array + d->size; while (i != b) new (--i) T; } else { qMemSet(p->array, 0, asize * sizeof(T)); } } template QVector::QVector(int asize, const T &t) { d = malloc(asize); d->ref = 1; d->alloc = d->size = asize; d->sharable = true; d->capacity = false; T* i = p->array + d->size; while (i != p->array) new (--i) T(t); } #ifdef Q_COMPILER_INITIALIZER_LISTS template QVector::QVector(std::initializer_list args) { d = malloc(int(args.size())); d->ref = 1; d->alloc = d->size = int(args.size()); d->sharable = true; d->capacity = false; T* i = p->array + d->size; auto it = args.end(); while (i != p->array) new (--i) T(*(--it)); } #endif template void QVector::free(Data *x) { if (QTypeInfo::isComplex) { T* b = x->array; union { QVectorData *d; Data *p; } u; u.p = x; T* i = b + u.d->size; while (i-- != b) i->~T(); } x->free(x, alignOfTypedData()); } template void QVector::realloc(int asize, int aalloc) { Q_ASSERT(asize <= aalloc); T *pOld; T *pNew; union { QVectorData *d; Data *p; } x; x.d = d; if (QTypeInfo::isComplex && asize < d->size && d->ref == 1 ) { // call the destructor on all objects that need to be // destroyed when shrinking pOld = p->array + d->size; pNew = p->array + asize; while (asize < d->size) { (--pOld)->~T(); d->size--; } } if (aalloc != d->alloc || d->ref != 1) { // (re)allocate memory if (QTypeInfo::isStatic) { x.d = malloc(aalloc); Q_CHECK_PTR(x.p); x.d->size = 0; } else if (d->ref != 1) { x.d = malloc(aalloc); Q_CHECK_PTR(x.p); if (QTypeInfo::isComplex) { x.d->size = 0; } else { ::memcpy(x.p, p, sizeOfTypedData() + (qMin(aalloc, d->alloc) - 1) * sizeof(T)); x.d->size = d->size; } } else { QT_TRY { QVectorData *mem = QVectorData::reallocate(d, sizeOfTypedData() + (aalloc - 1) * sizeof(T), sizeOfTypedData() + (d->alloc - 1) * sizeof(T), alignOfTypedData()); Q_CHECK_PTR(mem); x.d = d = mem; x.d->size = d->size; } QT_CATCH (const std::bad_alloc &) { if (aalloc > d->alloc) // ignore the error in case we are just shrinking. QT_RETHROW; } } x.d->ref = 1; x.d->alloc = aalloc; x.d->sharable = true; x.d->capacity = d->capacity; x.d->reserved = 0; } if (QTypeInfo::isComplex) { QT_TRY { pOld = p->array + x.d->size; pNew = x.p->array + x.d->size; // copy objects from the old array into the new array const int toMove = qMin(asize, d->size); while (x.d->size < toMove) { new (pNew++) T(*pOld++); x.d->size++; } // construct all new objects when growing while (x.d->size < asize) { new (pNew++) T; x.d->size++; } } QT_CATCH (...) { free(x.p); QT_RETHROW; } } else if (asize > x.d->size) { // initialize newly allocated memory to 0 qMemSet(x.p->array + x.d->size, 0, (asize - x.d->size) * sizeof(T)); } x.d->size = asize; if (d != x.d) { if (!d->ref.deref()) free(p); d = x.d; } } template Q_OUTOFLINE_TEMPLATE T QVector::value(int i) const { if (i < 0 || i >= d->size) { return T(); } return p->array[i]; } template Q_OUTOFLINE_TEMPLATE T QVector::value(int i, const T &defaultValue) const { return ((i < 0 || i >= d->size) ? defaultValue : p->array[i]); } template void QVector::append(const T &t) { if (d->ref != 1 || d->size + 1 > d->alloc) { const T copy(t); realloc(d->size, (d->size + 1 > d->alloc) ? QVectorData::grow(sizeOfTypedData(), d->size + 1, sizeof(T), QTypeInfo::isStatic) : d->alloc); if (QTypeInfo::isComplex) new (p->array + d->size) T(copy); else p->array[d->size] = copy; } else { if (QTypeInfo::isComplex) new (p->array + d->size) T(t); else p->array[d->size] = t; } ++d->size; } template typename QVector::iterator QVector::insert(iterator before, size_type n, const T &t) { int offset = int(before - p->array); if (n != 0) { const T copy(t); if (d->ref != 1 || d->size + n > d->alloc) realloc(d->size, QVectorData::grow(sizeOfTypedData(), d->size + n, sizeof(T), QTypeInfo::isStatic)); if (QTypeInfo::isStatic) { T *b = p->array + d->size; T *i = p->array + d->size + n; while (i != b) new (--i) T; i = p->array + d->size; T *j = i + n; b = p->array + offset; while (i != b) *--j = *--i; i = b+n; while (i != b) *--i = copy; } else { T *b = p->array + offset; T *i = b + n; memmove(i, b, (d->size - offset) * sizeof(T)); while (i != b) new (--i) T(copy); } d->size += n; } return p->array + offset; } template typename QVector::iterator QVector::erase(iterator abegin, iterator aend) { int f = int(abegin - p->array); int l = int(aend - p->array); int n = l - f; detach(); if (QTypeInfo::isComplex) { qCopy(p->array+l, p->array+d->size, p->array+f); T *i = p->array+d->size; T* b = p->array+d->size-n; while (i != b) { --i; i->~T(); } } else { memmove(p->array + f, p->array + l, (d->size-l)*sizeof(T)); } d->size -= n; return p->array + f; } template bool QVector::operator==(const QVector &v) const { if (d->size != v.d->size) return false; if (d == v.d) return true; T* b = p->array; T* i = b + d->size; T* j = v.p->array + d->size; while (i != b) if (!(*--i == *--j)) return false; return true; } template QVector &QVector::fill(const T &from, int asize) { const T copy(from); resize(asize < 0 ? d->size : asize); if (d->size) { T *i = p->array + d->size; T *b = p->array; while (i != b) *--i = copy; } return *this; } template QVector &QVector::operator+=(const QVector &l) { int newSize = d->size + l.d->size; realloc(d->size, newSize); T *w = p->array + newSize; T *i = l.p->array + l.d->size; T *b = l.p->array; while (i != b) { if (QTypeInfo::isComplex) new (--w) T(*--i); else *--w = *--i; } d->size = newSize; return *this; } template int QVector::indexOf(const T &t, int from) const { if (from < 0) from = qMax(from + d->size, 0); if (from < d->size) { T* n = p->array + from - 1; T* e = p->array + d->size; while (++n != e) if (*n == t) return n - p->array; } return -1; } template int QVector::lastIndexOf(const T &t, int from) const { if (from < 0) from += d->size; else if (from >= d->size) from = d->size-1; if (from >= 0) { T* b = p->array; T* n = p->array + from + 1; while (n != b) { if (*--n == t) return n - b; } } return -1; } template bool QVector::contains(const T &t) const { T* b = p->array; T* i = p->array + d->size; while (i != b) if (*--i == t) return true; return false; } template int QVector::count(const T &t) const { int c = 0; T* b = p->array; T* i = p->array + d->size; while (i != b) if (*--i == t) ++c; return c; } template Q_OUTOFLINE_TEMPLATE QVector QVector::mid(int pos, int length) const { if (length < 0) length = size() - pos; if (pos == 0 && length == size()) return *this; if (pos + length > size()) length = size() - pos; QVector copy; copy.reserve(length); for (int i = pos; i < pos + length; ++i) copy += at(i); return copy; } template Q_OUTOFLINE_TEMPLATE QList QVector::toList() const { QList result; result.reserve(size()); for (int i = 0; i < size(); ++i) result.append(at(i)); return result; } template Q_OUTOFLINE_TEMPLATE QVector QList::toVector() const { QVector result(size()); for (int i = 0; i < size(); ++i) result[i] = at(i); return result; } template QVector QVector::fromList(const QList &list) { return list.toVector(); } template QList QList::fromVector(const QVector &vector) { return vector.toList(); } Q_DECLARE_SEQUENTIAL_ITERATOR(Vector) Q_DECLARE_MUTABLE_SEQUENTIAL_ITERATOR(Vector) /* ### Qt 5: ### This needs to be removed for next releases of Qt. It is a workaround for vc++ because ### Qt exports QPolygon and QPolygonF that inherit QVector and ### QVector respectively. */ #ifdef Q_CC_MSVC QT_BEGIN_INCLUDE_NAMESPACE #include #include QT_END_INCLUDE_NAMESPACE #if defined(QT_BUILD_CORE_LIB) #define Q_TEMPLATE_EXTERN #else #define Q_TEMPLATE_EXTERN extern #endif Q_TEMPLATE_EXTERN template class Q_CORE_EXPORT QVector; Q_TEMPLATE_EXTERN template class Q_CORE_EXPORT QVector; #endif QT_END_NAMESPACE QT_END_HEADER #endif // QVECTOR_H