// ***************************************************************************** // * This file is part of the FreeFileSync project. It is distributed under * // * GNU General Public License: https://www.gnu.org/licenses/gpl-3.0 * // * Copyright (C) Zenju (zenju AT freefilesync DOT org) - All Rights Reserved * // ***************************************************************************** #ifndef STL_TOOLS_H_84567184321434 #define STL_TOOLS_H_84567184321434 #include #include #include #include #include #include #include #include "string_traits.h" //enhancements for namespace zen { //append STL containers template void append(std::vector& v, const C& c); template void append(std::set& s, const C& c); template void append(std::map& m, const C& c); template void removeDuplicates(std::vector& v); template void removeDuplicates(std::vector& v, CompLess less); //searching STL containers template BidirectionalIterator findLast(BidirectionalIterator first, BidirectionalIterator last, const T& value); //replacement for std::find_end taking advantage of bidirectional iterators (and giving the algorithm a reasonable name) template BidirectionalIterator1 searchLast(BidirectionalIterator1 first1, BidirectionalIterator1 last1, BidirectionalIterator2 first2, BidirectionalIterator2 last2); //binary search returning an iterator template Iterator binarySearch(Iterator first, Iterator last, const T& value, CompLess less); //read-only variant of std::merge; input: two sorted ranges template void mergeTraversal(Iterator first1, Iterator last1, Iterator first2, Iterator last2, FunctionLeftOnly lo, FunctionBoth bo, FunctionRightOnly ro); template Num hashBytes (ByteIterator first, ByteIterator last); template Num hashBytesAppend(Num hashVal, ByteIterator first, ByteIterator last); //support for custom string classes in std::unordered_set/map struct StringHash { template size_t operator()(const String& str) const { const auto* strFirst = strBegin(str); return hashBytes(reinterpret_cast(strFirst), reinterpret_cast(strFirst + strLength(str))); } }; //why, oh why is there no std::optional::get()??? template inline T* get( std::optional& opt) { return opt ? &*opt : nullptr; } template inline const T* get(const std::optional& opt) { return opt ? &*opt : nullptr; } //=========================================================================== template class SharedRef; template SharedRef makeSharedRef(Args&& ... args); template class SharedRef //why is there no std::shared_ref??? { public: SharedRef() = delete; //no surprise memory allocations! explicit SharedRef(std::shared_ptr ptr) : ref_(std::move(ptr)) { assert(ref_); } template SharedRef(const SharedRef& other) : ref_(other.ref_) {} /**/ T& ref() { return *ref_; }; const T& ref() const { return *ref_; }; std::shared_ptr< T> ptr() { return ref_; }; std::shared_ptr ptr() const { return ref_; }; private: template friend class SharedRef; std::shared_ptr ref_; //always bound }; template inline SharedRef makeSharedRef(Args&& ... args) { return SharedRef(std::make_shared(std::forward(args)...)); } //=========================================================================== //######################## implementation ######################## template inline void append(std::vector& v, const C& c) { v.insert(v.end(), c.begin(), c.end()); } template inline void append(std::set& s, const C& c) { s.insert(c.begin(), c.end()); } template inline void append(std::map& m, const C& c) { m.insert(c.begin(), c.end()); } template inline void removeDuplicates(std::vector& v, CompLess less, CompEqual eq) { std::sort(v.begin(), v.end(), less); v.erase(std::unique(v.begin(), v.end(), eq), v.end()); } template inline void removeDuplicates(std::vector& v, CompLess less) { removeDuplicates(v, less, [&](const auto& lhs, const auto& rhs) { return !less(lhs, rhs) && !less(rhs, lhs); }); } template inline void removeDuplicates(std::vector& v) { removeDuplicates(v, std::less(), std::equal_to()); } template inline Iterator binarySearch(Iterator first, Iterator last, const T& value, CompLess less) { static_assert(std::is_same_v::iterator_category, std::random_access_iterator_tag>); first = std::lower_bound(first, last, value, less); if (first != last && !less(value, *first)) return first; else return last; } template inline BidirectionalIterator findLast(const BidirectionalIterator first, const BidirectionalIterator last, const T& value) { for (BidirectionalIterator it = last; it != first;) //reverse iteration: 1. check 2. decrement 3. evaluate { --it; // if (*it == value) return it; } return last; } template inline BidirectionalIterator1 searchLast(const BidirectionalIterator1 first1, BidirectionalIterator1 last1, const BidirectionalIterator2 first2, const BidirectionalIterator2 last2) { const BidirectionalIterator1 itNotFound = last1; //reverse iteration: 1. check 2. decrement 3. evaluate for (;;) { BidirectionalIterator1 it1 = last1; BidirectionalIterator2 it2 = last2; for (;;) { if (it2 == first2) return it1; if (it1 == first1) return itNotFound; --it1; --it2; if (*it1 != *it2) break; } --last1; } } //--------------------------------------------------------------------------------------- //http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2018/p0458r2.html template >> inline bool contains(const Container& c, const ValueType& val, int dummy = 0 /*overload string_tools.h contains()*/) { return c.find(val) != c.end(); } //--------------------------------------------------------------------------------------- //read-only variant of std::merge; input: two sorted ranges template inline void mergeTraversal(Iterator first1, Iterator last1, Iterator first2, Iterator last2, FunctionLeftOnly lo, FunctionBoth bo, FunctionRightOnly ro) { auto itL = first1; auto itR = first2; auto finishLeft = [&] { std::for_each(itL, last1, lo); }; auto finishRight = [&] { std::for_each(itR, last2, ro); }; if (itL == last1) return finishRight(); if (itR == last2) return finishLeft (); for (;;) if (itL->first < itR->first) { lo(*itL); if (++itL == last1) return finishRight(); } else if (itR->first < itL->first) { ro(*itR); if (++itR == last2) return finishLeft(); } else { bo(*itL, *itR); ++itL; // ++itR; //increment BOTH before checking for end of range! if (itL == last1) return finishRight(); if (itR == last2) return finishLeft (); //simplify loop by placing both EOB checks at the beginning? => slightly slower } } //FNV-1a: https://en.wikipedia.org/wiki/Fowler%E2%80%93Noll%E2%80%93Vo_hash_function template inline Num hashBytes(ByteIterator first, ByteIterator last) { static_assert(IsInteger::value); static_assert(sizeof(Num) == 4 || sizeof(Num) == 8); //macOS: size_t is "unsigned long" constexpr Num base = sizeof(Num) == 4 ? 2166136261U : 14695981039346656037ULL; return hashBytesAppend(base, first, last); } template inline Num hashBytesAppend(Num hashVal, ByteIterator first, ByteIterator last) { static_assert(sizeof(typename std::iterator_traits::value_type) == 1); constexpr Num prime = sizeof(Num) == 4 ? 16777619U : 1099511628211ULL; for (; first != last; ++first) { hashVal ^= static_cast(*first); hashVal *= prime; } return hashVal; } } #endif //STL_TOOLS_H_84567184321434