/**************************************************************************** ** ** Copyright (C) 2015 The Qt Company Ltd. ** Contact: http://www.qt.io/licensing/ ** ** This file is part of the QtCore module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL21$ ** 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 The Qt Company. For licensing terms ** and conditions see http://www.qt.io/terms-conditions. For further ** information use the contact form at http://www.qt.io/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 or version 3 as published by the Free ** Software Foundation and appearing in the file LICENSE.LGPLv21 and ** LICENSE.LGPLv3 included in the packaging of this file. Please review the ** following information to ensure the GNU Lesser General Public License ** requirements will be met: https://www.gnu.org/licenses/lgpl.html and ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. ** ** As a special exception, The Qt Company gives you certain additional ** rights. These rights are described in The Qt Company LGPL Exception ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #ifndef QVARLENGTHARRAY_H #define QVARLENGTHARRAY_H #include #include #include #include #include #include #include QT_BEGIN_NAMESPACE template class QPodList; // Prealloc = 256 by default, specified in qcontainerfwd.h template class QVarLengthArray { public: inline explicit QVarLengthArray(int size = 0); inline QVarLengthArray(const QVarLengthArray &other) : a(Prealloc), s(0), ptr(reinterpret_cast(array)) { append(other.constData(), other.size()); } inline ~QVarLengthArray() { if (QTypeInfo::isComplex) { T *i = ptr + s; while (i-- != ptr) i->~T(); } if (ptr != reinterpret_cast(array)) free(ptr); } inline QVarLengthArray &operator=(const QVarLengthArray &other) { if (this != &other) { clear(); append(other.constData(), other.size()); } return *this; } inline void removeLast() { Q_ASSERT(s > 0); realloc(s - 1, a); } inline int size() const { return s; } inline int count() const { return s; } inline int length() const { return s; } 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() - 1); } const T& last() const { Q_ASSERT(!isEmpty()); return *(end() - 1); } inline bool isEmpty() const { return (s == 0); } inline void resize(int size); inline void clear() { resize(0); } inline void squeeze(); inline int capacity() const { return a; } inline void reserve(int size); inline int indexOf(const T &t, int from = 0) const; inline int lastIndexOf(const T &t, int from = -1) const; inline bool contains(const T &t) const; inline T &operator[](int idx) { Q_ASSERT(idx >= 0 && idx < s); return ptr[idx]; } inline const T &operator[](int idx) const { Q_ASSERT(idx >= 0 && idx < s); return ptr[idx]; } inline const T &at(int idx) const { return operator[](idx); } T value(int i) const; T value(int i, const T &defaultValue) const; inline void append(const T &t) { if (s == a) // i.e. s != 0 realloc(s, s<<1); const int idx = s++; if (QTypeInfo::isComplex) { new (ptr + idx) T(t); } else { ptr[idx] = t; } } void append(const T *buf, int size); inline QVarLengthArray &operator<<(const T &t) { append(t); return *this; } inline QVarLengthArray &operator+=(const T &t) { append(t); return *this; } 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); inline T *data() { return ptr; } inline const T *data() const { return ptr; } inline const T * constData() const { return ptr; } 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; typedef T* iterator; typedef const T* const_iterator; inline iterator begin() { return ptr; } inline const_iterator begin() const { return ptr; } inline const_iterator cbegin() const { return ptr; } inline const_iterator constBegin() const { return ptr; } inline iterator end() { return ptr + s; } inline const_iterator end() const { return ptr + s; } inline const_iterator cend() const { return ptr + s; } inline const_iterator constEnd() const { return ptr + s; } iterator insert(const_iterator before, int n, const T &x); inline iterator insert(const_iterator before, const T &x) { return insert(before, 1, x); } iterator erase(const_iterator begin, const_iterator end); inline iterator erase(const_iterator pos) { return erase(pos, pos+1); } // STL compatibility: inline bool empty() const { return isEmpty(); } inline void push_back(const T &t) { append(t); } inline void pop_back() { removeLast(); } inline T &front() { return first(); } inline const T &front() const { return first(); } inline T &back() { return last(); } inline const T &back() const { return last(); } private: friend class QPodList; void realloc(int size, int alloc); int a; // capacity int s; // size T *ptr; // data union { char array[Prealloc * sizeof(T)]; qint64 q_for_alignment_1; double q_for_alignment_2; }; bool isValidIterator(const const_iterator &i) const { return (i <= constEnd()) && (constBegin() <= i); } }; template Q_INLINE_TEMPLATE QVarLengthArray::QVarLengthArray(int asize) : s(asize) { Q_STATIC_ASSERT_X(Prealloc > 0, "QVarLengthArray Prealloc must be greater than 0."); Q_ASSERT_X(s >= 0, "QVarLengthArray::QVarLengthArray()", "Size must be greater than or equal to 0."); if (s > Prealloc) { ptr = reinterpret_cast(malloc(s * sizeof(T))); Q_CHECK_PTR(ptr); a = s; } else { ptr = reinterpret_cast(array); a = Prealloc; } if (QTypeInfo::isComplex) { T *i = ptr + s; while (i != ptr) new (--i) T; } } template Q_INLINE_TEMPLATE void QVarLengthArray::resize(int asize) { realloc(asize, qMax(asize, a)); } template Q_INLINE_TEMPLATE void QVarLengthArray::reserve(int asize) { if (asize > a) realloc(s, asize); } template Q_INLINE_TEMPLATE int QVarLengthArray::indexOf(const T &t, int from) const { if (from < 0) from = qMax(from + s, 0); if (from < s) { T *n = ptr + from - 1; T *e = ptr + s; while (++n != e) if (*n == t) return n - ptr; } return -1; } template Q_INLINE_TEMPLATE int QVarLengthArray::lastIndexOf(const T &t, int from) const { if (from < 0) from += s; else if (from >= s) from = s - 1; if (from >= 0) { T *b = ptr; T *n = ptr + from + 1; while (n != b) { if (*--n == t) return n - b; } } return -1; } template Q_INLINE_TEMPLATE bool QVarLengthArray::contains(const T &t) const { T *b = ptr; T *i = ptr + s; while (i != b) { if (*--i == t) return true; } return false; } template Q_OUTOFLINE_TEMPLATE void QVarLengthArray::append(const T *abuf, int increment) { Q_ASSERT(abuf); if (increment <= 0) return; const int asize = s + increment; if (asize >= a) realloc(s, qMax(s*2, asize)); if (QTypeInfo::isComplex) { // call constructor for new objects (which can throw) while (s < asize) new (ptr+(s++)) T(*abuf++); } else { memcpy(&ptr[s], abuf, increment * sizeof(T)); s = asize; } } template Q_INLINE_TEMPLATE void QVarLengthArray::squeeze() { realloc(s, s); } template Q_OUTOFLINE_TEMPLATE void QVarLengthArray::realloc(int asize, int aalloc) { Q_ASSERT(aalloc >= asize); T *oldPtr = ptr; int osize = s; const int copySize = qMin(asize, osize); if (aalloc != a) { if (aalloc > Prealloc) { T* newPtr = reinterpret_cast(malloc(aalloc * sizeof(T))); Q_CHECK_PTR(newPtr); // could throw // by design: in case of QT_NO_EXCEPTIONS malloc must not fail or it crashes here ptr = newPtr; a = aalloc; } else { ptr = reinterpret_cast(array); a = Prealloc; } s = 0; if (QTypeInfo::isStatic) { QT_TRY { // copy all the old elements while (s < copySize) { new (ptr+s) T(*(oldPtr+s)); (oldPtr+s)->~T(); s++; } } QT_CATCH(...) { // clean up all the old objects and then free the old ptr int sClean = s; while (sClean < osize) (oldPtr+(sClean++))->~T(); if (oldPtr != reinterpret_cast(array) && oldPtr != ptr) free(oldPtr); QT_RETHROW; } } else { memcpy(ptr, oldPtr, copySize * sizeof(T)); } } s = copySize; if (QTypeInfo::isComplex) { // destroy remaining old objects while (osize > asize) (oldPtr+(--osize))->~T(); } if (oldPtr != reinterpret_cast(array) && oldPtr != ptr) free(oldPtr); if (QTypeInfo::isComplex) { // call default constructor for new objects (which can throw) while (s < asize) new (ptr+(s++)) T; } else { s = asize; } } template Q_OUTOFLINE_TEMPLATE T QVarLengthArray::value(int i) const { if (uint(i) >= uint(size())) { return T(); } return at(i); } template Q_OUTOFLINE_TEMPLATE T QVarLengthArray::value(int i, const T &defaultValue) const { return (uint(i) >= uint(size())) ? defaultValue : at(i); } template inline void QVarLengthArray::insert(int i, const T &t) { Q_ASSERT_X(i >= 0 && i <= s, "QVarLengthArray::insert", "index out of range"); insert(begin() + i, 1, t); } template inline void QVarLengthArray::insert(int i, int n, const T &t) { Q_ASSERT_X(i >= 0 && i <= s, "QVarLengthArray::insert", "index out of range"); insert(begin() + i, n, t); } template inline void QVarLengthArray::remove(int i, int n) { Q_ASSERT_X(i >= 0 && n >= 0 && i + n <= s, "QVarLengthArray::remove", "index out of range"); erase(begin() + i, begin() + i + n); } template inline void QVarLengthArray::remove(int i) { Q_ASSERT_X(i >= 0 && i < s, "QVarLengthArray::remove", "index out of range"); erase(begin() + i, begin() + i + 1); } template inline void QVarLengthArray::prepend(const T &t) { insert(begin(), 1, t); } template inline void QVarLengthArray::replace(int i, const T &t) { Q_ASSERT_X(i >= 0 && i < s, "QVarLengthArray::replace", "index out of range"); const T copy(t); data()[i] = copy; } template Q_OUTOFLINE_TEMPLATE typename QVarLengthArray::iterator QVarLengthArray::insert(const_iterator before, size_type n, const T &t) { Q_ASSERT_X(isValidIterator(before), "QVarLengthArray::insert", "The specified const_iterator argument 'before' is invalid"); int offset = int(before - ptr); if (n != 0) { resize(s + n); const T copy(t); if (QTypeInfo::isStatic) { T *b = ptr + offset; T *j = ptr + s; T *i = j - n; while (i != b) *--j = *--i; i = b + n; while (i != b) *--i = copy; } else { T *b = ptr + offset; T *i = b + n; memmove(i, b, (s - offset - n) * sizeof(T)); while (i != b) new (--i) T(copy); } } return ptr + offset; } template Q_OUTOFLINE_TEMPLATE typename QVarLengthArray::iterator QVarLengthArray::erase(const_iterator abegin, const_iterator aend) { Q_ASSERT_X(isValidIterator(abegin), "QVarLengthArray::insert", "The specified const_iterator argument 'abegin' is invalid"); Q_ASSERT_X(isValidIterator(aend), "QVarLengthArray::insert", "The specified const_iterator argument 'aend' is invalid"); int f = int(abegin - ptr); int l = int(aend - ptr); int n = l - f; if (QTypeInfo::isComplex) { std::copy(ptr + l, ptr + s, ptr + f); T *i = ptr + s; T *b = ptr + s - n; while (i != b) { --i; i->~T(); } } else { memmove(ptr + f, ptr + l, (s - l) * sizeof(T)); } s -= n; return ptr + f; } template bool operator==(const QVarLengthArray &l, const QVarLengthArray &r) { if (l.size() != r.size()) return false; for (int i = 0; i < l.size(); i++) { if (l.at(i) != r.at(i)) return false; } return true; } template bool operator!=(const QVarLengthArray &l, const QVarLengthArray &r) { return !(l == r); } QT_END_NAMESPACE #endif // QVARLENGTHARRAY_H