/****************************************************************************** * Copyright (C) 2016 Kitsune Ral * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA */ #pragma once #include #include #include #include #include // Along the lines of Q_DISABLE_COPY - the upstream version comes in Qt 5.13 #define DISABLE_MOVE(_ClassName) \ _ClassName(_ClassName&&) Q_DECL_EQ_DELETE; \ _ClassName& operator=(_ClassName&&) Q_DECL_EQ_DELETE; namespace Quotient { /// An equivalent of std::hash for QTypes to enable std::unordered_map template struct HashQ { size_t operator()(const T& s) const Q_DECL_NOEXCEPT { return qHash(s, uint(qGlobalQHashSeed())); } }; /// A wrapper around std::unordered_map compatible with types that have qHash template using UnorderedMap = std::unordered_map>; struct NoneTag {}; constexpr NoneTag none {}; /** A crude substitute for `optional` while we're not C++17 * * Only works with default-constructible types. */ template class Omittable { static_assert(!std::is_reference::value, "You cannot make an Omittable<> with a reference type"); public: using value_type = std::decay_t; explicit Omittable() : Omittable(none) {} Omittable(NoneTag) : _value(value_type()), _omitted(true) {} Omittable(const value_type& val) : _value(val) {} Omittable(value_type&& val) : _value(std::move(val)) {} Omittable& operator=(const value_type& val) { _value = val; _omitted = false; return *this; } Omittable& operator=(value_type&& val) { // For some reason GCC complains about -Wmaybe-uninitialized // in the context of using Omittable with converters.h; // though the logic looks very much benign (GCC bug???) _value = std::move(val); _omitted = false; return *this; } bool operator==(const value_type& rhs) const { return !omitted() && value() == rhs; } friend bool operator==(const value_type& lhs, const Omittable& rhs) { return rhs == lhs; } bool operator!=(const value_type& rhs) const { return !operator==(rhs); } friend bool operator!=(const value_type& lhs, const Omittable& rhs) { return !(rhs == lhs); } bool omitted() const { return _omitted; } const value_type& value() const { Q_ASSERT(!_omitted); return _value; } value_type& editValue() { _omitted = false; return _value; } /// Merge the value from another Omittable /// \return true if \p other is not omitted and the value of /// the current Omittable was different (or omitted); /// in other words, if the current Omittable has changed; /// false otherwise template auto merge(const Omittable& other) -> std::enable_if_t::value, bool> { if (other.omitted() || (!_omitted && _value == other.value())) return false; _omitted = false; _value = other.value(); return true; } value_type&& release() { _omitted = true; return std::move(_value); } const value_type* operator->() const& { return &value(); } value_type* operator->() & { return &editValue(); } const value_type& operator*() const& { return value(); } value_type& operator*() & { return editValue(); } private: T _value; bool _omitted = false; }; namespace _impl { template struct fn_traits; } /// Determine traits of an arbitrary function/lambda/functor /*! * Doesn't work with generic lambdas and function objects that have * operator() overloaded. * \sa * https://stackoverflow.com/questions/7943525/is-it-possible-to-figure-out-the-parameter-type-and-return-type-of-a-lambda#7943765 */ template struct function_traits : public _impl::fn_traits> {}; // Specialisation for a function template struct function_traits { using return_type = ReturnT; using arg_types = std::tuple; // Doesn't (and there's no plan to make it) work for "classic" // member functions (i.e. outside of functors). // See also the comment for wrap_in_function() below using function_type = std::function; }; namespace _impl { // Specialisation for function objects with (non-overloaded) operator() // (this includes non-generic lambdas) template struct fn_traits : public fn_traits {}; // Specialisation for a member function template struct fn_traits : function_traits {}; // Specialisation for a const member function template struct fn_traits : function_traits {}; } // namespace _impl template using fn_return_t = typename function_traits::return_type; template using fn_arg_t = std::tuple_element_t::arg_types>; // TODO: get rid of it as soon as Apple Clang gets proper deduction guides // for std::function<> template inline auto wrap_in_function(FnT&& f) { return typename function_traits::function_type(std::forward(f)); } inline auto operator"" _ls(const char* s, std::size_t size) { return QLatin1String(s, int(size)); } /** An abstraction over a pair of iterators * This is a very basic range type over a container with iterators that * are at least ForwardIterators. Inspired by Ranges TS. */ template class Range { // Looking forward for Ranges TS to produce something (in C++23?..) using iterator = typename ArrayT::iterator; using const_iterator = typename ArrayT::const_iterator; using size_type = typename ArrayT::size_type; public: Range(ArrayT& arr) : from(std::begin(arr)), to(std::end(arr)) {} Range(iterator from, iterator to) : from(from), to(to) {} size_type size() const { Q_ASSERT(std::distance(from, to) >= 0); return size_type(std::distance(from, to)); } bool empty() const { return from == to; } const_iterator begin() const { return from; } const_iterator end() const { return to; } iterator begin() { return from; } iterator end() { return to; } private: iterator from; iterator to; }; /** A replica of std::find_first_of that returns a pair of iterators * * Convenient for cases when you need to know which particular "first of" * [sFirst, sLast) has been found in [first, last). */ template inline std::pair findFirstOf(InputIt first, InputIt last, ForwardIt sFirst, ForwardIt sLast, Pred pred) { for (; first != last; ++first) for (auto it = sFirst; it != sLast; ++it) if (pred(*first, *it)) return std::make_pair(first, it); return std::make_pair(last, sLast); } /** Convert what looks like a URL or a Matrix ID to an HTML hyperlink */ void linkifyUrls(QString& htmlEscapedText); /** Sanitize the text before showing in HTML * * This does toHtmlEscaped() and removes Unicode BiDi marks. */ QString sanitized(const QString& plainText); /** Pretty-print plain text into HTML * * This includes HTML escaping of <,>,",& and calling linkifyUrls() */ QString prettyPrint(const QString& plainText); /** Return a path to cache directory after making sure that it exists * * The returned path has a trailing slash, clients don't need to append it. * \param dir path to cache directory relative to the standard cache path */ QString cacheLocation(const QString& dirName); /** Hue color component of based of the hash of the string. * * The implementation is based on XEP-0392: * https://xmpp.org/extensions/xep-0392.html * Naming and range are the same as QColor's hueF method: * https://doc.qt.io/qt-5/qcolor.html#integer-vs-floating-point-precision */ qreal stringToHueF(const QString& s); /** Extract the serverpart from MXID */ QString serverPart(const QString& mxId); } // namespace Quotient /// \deprecated Use namespace Quotient instead namespace QMatrixClient = Quotient;