matcher.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2025 Manuel Schneider
// SPDX-License-Identifier: MIT
 
#pragma once
#include <QRegularExpression>
#include <QString>
#include <albert/export.h>
#include <albert/matchconfig.h>
#include <ranges>
class MatcherPrivate;
 
namespace albert
{
 
class ALBERT_EXPORT Match final
{
public:
    using Score = double;
 
    Match() : score_(-1.) {}
 
    Match(const Score score) : score_(score) {}
 
    Match(const Match &o) = default;
 
    Match &operator=(const Match &o) = default;
 
    inline bool isMatch() const { return score_ >= 0.0; }
 
    inline bool isEmptyMatch() const { return qFuzzyCompare(score_, 0.0); }
 
    inline bool isExactMatch() const { return qFuzzyCompare(score_, 1.0); }
 
    inline Score score() const { return score_; }
 
    inline explicit operator bool() const { return isMatch(); }
 
    inline operator Score() const { return score_; }
 
private:
 
    Score score_;
};
 
 
class ALBERT_EXPORT Matcher final
{
public:
    Matcher(const QString &string, MatchConfig config = {});
 
    Matcher(Matcher &&o);
 
    Matcher &operator=(Matcher &&o);
 
    ~Matcher();
 
    const QString &string() const;
 
    Match match(const QString &string) const;
 
    Match match(QString first, auto... remainder) const
    { return std::max(match(first), match(remainder...)); }
 
    Match match(std::ranges::range auto &&strings) const
         requires std::same_as<std::ranges::range_value_t<decltype(strings)>, QString>
    {
        if (strings.empty())
            return Match();
        return std::ranges::max(
            strings | std::views::transform([this](const QString &s) { return this->match(s); }));
    }
 
 
private:
 
    class Private;
    std::unique_ptr<Private> d;
 
};
 
}