/* Copyright (C) 2013 * swift project Community / Contributors * * This file is part of swift project. It is subject to the license terms in the LICENSE file found in the top-level * directory of this distribution and at http://www.swift-project.org/license.html. No part of swift project, * including this file, may be copied, modified, propagated, or distributed except according to the terms * contained in the LICENSE file. */ //! \file #ifndef BLACKMISC_COLLECTION_H #define BLACKMISC_COLLECTION_H #include "iterator.h" #include "containerbase.h" #include #include #include #include #include #include namespace BlackMisc { /*! * Needed for compatibility with C++ standard algorithms which expect ordered sets. */ template class QOrderedSet : public QMap { public: //! Type of values stored in the set. typedef T value_type; //! Insert a new value into the set. typename QMap::iterator insert(const T &value) { return QMap::insert(value, value); } //! Default constructor. QOrderedSet() {} //! Initializer list constructor. QOrderedSet(std::initializer_list il) { for (const auto &v : il) { insert(v); } } }; /*! * \brief Generic type-erased ordered container with value semantics. * \tparam T the type of elements contained. * * Can take any suitable container class as its implementation at runtime. */ template class CCollection : public CContainerBase> { public: //! \brief STL compatibility //! @{ typedef T key_type; typedef T value_type; typedef T &reference; typedef const T &const_reference; typedef T *pointer; typedef const T *const_pointer; typedef typename Iterators::ConstForwardIterator const_iterator; typedef const_iterator iterator; // can't modify elements in-place typedef ptrdiff_t difference_type; typedef intptr_t size_type; //! @} /*! * \brief Default constructor. */ CCollection() : m_pimpl(new Pimpl>(QOrderedSet())) {} /*! * \brief Initializer list constructor. */ CCollection(std::initializer_list il) : m_pimpl(new Pimpl>(QOrderedSet(il))) {} /*! * \brief Copy constructor. */ CCollection(const CCollection &other) : m_pimpl(other.pimpl() ? other.pimpl()->clone() : nullptr) {} /*! * \brief Move constructor. */ CCollection(CCollection &&other) : m_pimpl(other.m_pimpl.take()) {} /*! * \brief Copy assignment. */ CCollection &operator =(const CCollection &other) { m_pimpl.reset(other.pimpl() ? other.pimpl()->clone() : nullptr); return *this; } /*! * \brief Move assignment. */ CCollection &operator =(CCollection && other) { m_pimpl.reset(other.m_pimpl.take()); return *this; } /*! * \brief Create a new collection with a specific implementation type. * \tparam C Becomes the collection's implementation type. * \param c Initial value for the collection; default is empty, but it could contain elements if desired. The value is copied. */ template static CCollection fromImpl(C c = C()) { return CCollection(new Pimpl(std::move(c))); } /*! * \brief Change the implementation type but keep all the same elements, by moving them into the new implementation. * \tparam C Becomes the collection's new implementation type. */ template void changeImpl(C = C()) { auto c = fromImpl(C()); std::move(begin(), end(), std::inserter(c, c.begin())); *this = std::move(c); } /*! * \brief Like changeImpl, but uses the implementation type of another collection. * \pre The other collection must be initialized. */ void useImplOf(const CCollection &other) { PimplPtr p = other.pimpl()->cloneEmpty(); std::move(begin(), end(), std::inserter(*p, p->begin())); m_pimpl.reset(p.take()); } /*! * \brief Returns iterator at the beginning of the collection. */ iterator begin() { return pimpl() ? pimpl()->begin() : iterator(); } /*! * \brief Returns iterator at the beginning of the collection. */ const_iterator begin() const { return pimpl() ? pimpl()->begin() : const_iterator(); } /*! * \brief Returns iterator at the beginning of the collection. */ const_iterator cbegin() const { return pimpl() ? pimpl()->cbegin() : const_iterator(); } /*! * \brief Returns iterator one past the end of the collection. */ iterator end() { return pimpl() ? pimpl()->end() : iterator(); } /*! * \brief Returns const iterator one past the end of the collection. */ const_iterator end() const { return pimpl() ? pimpl()->end() : const_iterator(); } /*! * \brief Returns const iterator one past the end of the collection. */ const_iterator cend() const { return pimpl() ? pimpl()->cend() : const_iterator(); } /*! * \brief Swap this collection with another. */ void swap(CCollection &other) { m_pimpl.swap(other.m_pimpl); } /*! * \brief Returns number of elements in the collection. */ size_type size() const { return pimpl() ? pimpl()->size() : 0; } /*! * \brief Returns true if the collection is empty. */ bool empty() const { return pimpl() ? pimpl()->empty() : true; } /*! * \brief Synonym for empty. */ bool isEmpty() const { return empty(); } /*! * \brief Removes all elements in the collection. */ void clear() { if (pimpl()) pimpl()->clear(); } /*! * \brief For compatibility with std::inserter. * \param hint Ignored. * \param value The value to insert. * \pre The collection must be initialized. */ iterator insert(const_iterator hint, const T &value) { Q_UNUSED(hint); return insert(value); } /*! * \brief For compatibility with std::inserter. * \param hint Ignored. * \param value The value to move in. * \pre The collection must be initialized. */ iterator insert(const_iterator hint, T &&value) { insert(std::move(value)); Q_UNUSED(hint); } /*! * \brief Inserts an element into the collection. * \return An iterator to the position where value was inserted. * \pre The collection must be initialized. */ iterator insert(const T &value) { Q_ASSERT(pimpl()); return pimpl()->insert(value); } /*! * \brief Moves an element into the collection. * \return An iterator to the position where value was inserted. * \pre The collection must be initialized. */ iterator insert(T &&value) { Q_ASSERT(pimpl()); return pimpl()->insert(std::move(value)); } /*! * \brief Inserts all elements from another collection into this collection. * \pre This collection must be initialized. */ void insert(const CCollection &other) { std::copy(other.begin(), other.end(), std::inserter(*this, begin())); } /*! * \brief Inserts all elements from another collection into this collection. * This version moves elements instead of copying. * \pre This collection must be initialized. */ void insert(CCollection &&other) { std::move(other.begin(), other.end(), std::inserter(*this, begin())); } /*! * \brief Appends all elements from a range at the end of this collection. * \pre This collection must be initialized. */ template void insert(const CRange &range) { std::copy(range.begin(), range.end(), std::back_inserter(*this)); } /*! * \brief Synonym for insert. * \return An iterator to the position where value was inserted. * \pre The collection must be initialized. */ iterator push_back(const T &value) { return insert(value); } /*! * \brief Synonym for insert. * \return An iterator to the position where value was inserted. * \pre The collection must be initialized. */ iterator push_back(T &&value) { return insert(std::move(value)); } /*! * \brief Synonym for insert. * \pre This collection must be initialized. */ void push_back(const CCollection &other) { insert(other); } /*! * \brief Synonym for insert. * \pre This collection must be initialized. */ void push_back(CCollection &&other) { insert(std::move(other)); } /*! * \brief Synonym for insert. * \pre This collection must be initialized. */ template void push_back(const CRange &range) { std::copy(range.begin(), range.end(), std::back_inserter(*this)); } /*! * \brief Returns a collection which is the union of this collection and another container. */ template CCollection makeUnion(const C &other) const { CCollection result; std::set_union(begin(), end(), other.begin(), other.end(), std::inserter(result, result.begin())); return result; } /*! * \brief Returns a collection which is the intersection of this collection and another. */ template CCollection intersection(const C &other) const { CCollection result; std::set_intersection(begin(), end(), other.begin(), other.end(), std::inserter(result, result.begin())); return result; } /*! * \brief Returns a collection which contains all the elements from this collection which are not in the other collection. */ template CCollection difference(const C &other) const { CCollection result; std::set_difference(begin(), end(), other.begin(), other.end(), std::inserter(result, result.begin())); return result; } /*! * \brief Remove the element pointed to by the given iterator. * \return An iterator to the position of the next element after the one removed. * \pre The collection must be initialized. */ iterator erase(iterator pos) { Q_ASSERT(pimpl()); return pimpl()->erase(pos); } /*! * \brief Remove the range of elements between two iterators. * \return An iterator to the position of the next element after the one removed. * \pre The sequence must be initialized. */ iterator erase(iterator it1, iterator it2) { Q_ASSERT(pimpl()); return pimpl()->erase(it1, it2); } /*! * \brief Efficient find method using the find of the implementation container. Typically O(log n). * \return An iterator to the position of the found element, or the end iterator if not found. * \pre The sequence must be initialized. * \warning Take care that the returned non-const iterator is not compared with a const iterator. */ iterator find(const T &value) { Q_ASSERT(pimpl()); return pimpl()->find(value); } /*! * \brief Efficient find method using the find of the implementation container. Typically O(log n). * \return An iterator to the position of the found element, or the end iterator if not found. * \pre The sequence must be initialized. */ const_iterator find(const T &value) const { Q_ASSERT(pimpl()); return pimpl()->find(value); } /*! * \brief Efficient remove using the find and erase of the implementation container. Typically O(log n). * \pre The sequence must be initialized. */ void remove(const T &object) { auto it = find(object); if (it != end()) { erase(it); } } /*! * \brief Removes from this collection all of the elements of another collection. * \pre This sequence must be initialized. */ void remove(const CCollection &other) { *this = CCollection(*this).difference(other); } /*! * \brief Test for equality. * \todo Improve inefficient implementation. */ bool operator ==(const CCollection &other) const { return (empty() && other.empty()) ? true : (size() != other.size() ? false : *pimpl() == *other.pimpl()); } /*! * \brief Test for inequality. * \todo Improve inefficient implementation. */ bool operator !=(const CCollection &other) const { return !(*this == other); } /*! * \brief Return an opaque pointer to the implementation container. * \details Can be useful in unusual debugging situations. * \warning Not for general use. */ void *getImpl() { return pimpl() ? pimpl()->impl() : nullptr; } private: class PimplBase { public: virtual ~PimplBase() {} virtual PimplBase *clone() const = 0; virtual PimplBase *cloneEmpty() const = 0; virtual iterator begin() = 0; virtual const_iterator begin() const = 0; virtual const_iterator cbegin() const = 0; virtual iterator end() = 0; virtual const_iterator end() const = 0; virtual const_iterator cend() const = 0; virtual size_type size() const = 0; virtual bool empty() const = 0; virtual void clear() = 0; virtual iterator insert(const T &value) = 0; virtual iterator insert(T &&value) = 0; virtual iterator erase(iterator pos) = 0; virtual iterator erase(iterator it1, iterator it2) = 0; virtual iterator find(const T &value) = 0; virtual const_iterator find(const T &value) const = 0; virtual bool operator ==(const PimplBase &other) const = 0; virtual void *impl() = 0; }; template class Pimpl : public PimplBase { public: static_assert(std::is_same::value, "CCollection must be initialized from a container with the same value_type."); Pimpl(C &&c) : m_impl(std::move(c)) {} PimplBase *clone() const override { return new Pimpl(*this); } PimplBase *cloneEmpty() const override { return new Pimpl(C()); } iterator begin() override { return iterator::fromImpl(m_impl.begin()); } const_iterator begin() const override { return const_iterator::fromImpl(m_impl.cbegin()); } const_iterator cbegin() const override { return const_iterator::fromImpl(m_impl.cbegin()); } iterator end() override { return iterator::fromImpl(m_impl.end()); } const_iterator end() const override { return const_iterator::fromImpl(m_impl.cend()); } const_iterator cend() const override { return const_iterator::fromImpl(m_impl.cend()); } size_type size() const override { return m_impl.size(); } bool empty() const override { return m_impl.empty(); } void clear() override { m_impl.clear(); } iterator insert(const T &value) override { return iterator::fromImpl(insertHelper(m_impl.insert(value))); } iterator insert(T &&value) override { return iterator::fromImpl(insertHelper(m_impl.insert(std::move(value)))); } iterator erase(iterator pos) override { return iterator::fromImpl(m_impl.erase(*static_cast(pos.getImpl()))); } //iterator erase(iterator it1, iterator it2) override { return iterator::fromImpl(m_impl.erase(*static_cast(it1.getImpl()), *static_cast(it2.getImpl()))); } iterator erase(iterator it1, iterator it2) override { while (it1 != it2) { it1 = iterator::fromImpl(m_impl.erase(*static_cast(it1.getImpl()))); } return it1; } iterator find(const T &value) override { return iterator::fromImpl(m_impl.find(value)); } const_iterator find(const T &value) const override { return const_iterator::fromImpl(m_impl.find(value)); } bool operator ==(const PimplBase &other) const override { Pimpl copy = C(); for (auto i = other.cbegin(); i != other.cend(); ++i) copy.insert(*i); return m_impl == copy.m_impl; } void *impl() override { return &m_impl; } private: C m_impl; // insertHelper: QOrderedSet::insert returns an iterator, but std::set::insert returns a std::pair template static I insertHelper(I i) { return i; } template static I insertHelper(std::pair p) { return p.first; } }; typedef QScopedPointer PimplPtr; PimplPtr m_pimpl; CCollection(PimplBase *pimpl) : m_pimpl(pimpl) {} // private ctor used by fromImpl() // using these methods to access m_pimpl.data() eases the cognitive burden of correctly forwarding const PimplBase *pimpl() { return m_pimpl.data(); } const PimplBase *pimpl() const { return m_pimpl.data(); } }; } //namespace BlackMisc Q_DECLARE_METATYPE(BlackMisc::CCollection) Q_DECLARE_METATYPE(BlackMisc::CCollection) Q_DECLARE_METATYPE(BlackMisc::CCollection) Q_DECLARE_METATYPE(BlackMisc::CCollection) // CCollection not instantiated due to it being a dumb idea because of rounding issues #endif // guard