/**************************************************************************** ** ** Copyright (C) 2016 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** 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 The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://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 3 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL3 included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 3 requirements ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 2.0 or (at your option) the GNU General ** Public license version 3 or any later version approved by the KDE Free ** Qt Foundation. The licenses are as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-2.0.html and ** https://www.gnu.org/licenses/gpl-3.0.html. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #ifndef QVARLENGTHARRAY_H #define QVARLENGTHARRAY_H #include #include #include #include #include #include #include #ifdef Q_COMPILER_INITIALIZER_LISTS #include #endif #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()); } #ifdef Q_COMPILER_INITIALIZER_LISTS QVarLengthArray(std::initializer_list args) : a(Prealloc), s(0), ptr(reinterpret_cast(array)) { if (args.size()) append(args.begin(), int(args.size())); } #endif 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; } #ifdef Q_COMPILER_INITIALIZER_LISTS QVarLengthArray &operator=(std::initializer_list list) { resize(list.size()); std::copy(list.begin(), list.end(), QT_MAKE_CHECKED_ARRAY_ITERATOR(this->begin(), this->size())); return *this; } #endif 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 T copy(t); realloc(s, s<<1); const int idx = s++; if (QTypeInfo::isComplex) { new (ptr + idx) T(std::move(copy)); } else { ptr[idx] = std::move(copy); } } else { const int idx = s++; if (QTypeInfo::isComplex) { new (ptr + idx) T(t); } else { ptr[idx] = t; } } } void append(T &&t) { if (s == a) realloc(s, s << 1); const int idx = s++; if (QTypeInfo::isComplex) new (ptr + idx) T(std::move(t)); else ptr[idx] = std::move(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; typedef std::reverse_iterator reverse_iterator; typedef std::reverse_iterator const_reverse_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; } reverse_iterator rbegin() { return reverse_iterator(end()); } reverse_iterator rend() { return reverse_iterator(begin()); } const_reverse_iterator rbegin() const { return const_reverse_iterator(end()); } const_reverse_iterator rend() const { return const_reverse_iterator(begin()); } const_reverse_iterator crbegin() const { return const_reverse_iterator(end()); } const_reverse_iterator crend() const { return const_reverse_iterator(begin()); } 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); } void push_back(T &&t) { append(std::move(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(static_cast(&ptr[s]), static_cast(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); Q_ASSUME(copySize >= 0); 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 (!QTypeInfoQuery::isRelocatable) { 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(static_cast(ptr), static_cast(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 (!QTypeInfoQuery::isRelocatable) { 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, QT_MAKE_CHECKED_ARRAY_ITERATOR(ptr + f, s - 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; const T *rb = r.begin(); const T *b = l.begin(); const T *e = l.end(); return std::equal(b, e, QT_MAKE_CHECKED_ARRAY_ITERATOR(rb, r.size())); } template bool operator!=(const QVarLengthArray &l, const QVarLengthArray &r) { return !(l == r); } template bool operator<(const QVarLengthArray &lhs, const QVarLengthArray &rhs) Q_DECL_NOEXCEPT_EXPR(noexcept(std::lexicographical_compare(lhs.begin(), lhs.end(), rhs.begin(), rhs.end()))) { return std::lexicographical_compare(lhs.begin(), lhs.end(), rhs.begin(), rhs.end()); } template inline bool operator>(const QVarLengthArray &lhs, const QVarLengthArray &rhs) Q_DECL_NOEXCEPT_EXPR(noexcept(lhs < rhs)) { return rhs < lhs; } template inline bool operator<=(const QVarLengthArray &lhs, const QVarLengthArray &rhs) Q_DECL_NOEXCEPT_EXPR(noexcept(lhs < rhs)) { return !(lhs > rhs); } template inline bool operator>=(const QVarLengthArray &lhs, const QVarLengthArray &rhs) Q_DECL_NOEXCEPT_EXPR(noexcept(lhs < rhs)) { return !(lhs < rhs); } QT_END_NAMESPACE #endif // QVARLENGTHARRAY_H