Files
scylladb/utils/like_matcher.hh
Kefu Chai 7215d4bfe9 utils: do not include unused headers
these unused includes were identifier by clang-include-cleaner. after
auditing these source files, all of the reports have been confirmed.

please note, because quite a few source files relied on
`utils/to_string.hh` to pull in the specialization of
`fmt::formatter<std::optional<T>>`, after removing
`#include <fmt/std.h>` from `utils/to_string.hh`, we have to
include `fmt/std.h` directly.

Signed-off-by: Kefu Chai <kefu.chai@scylladb.com>
2025-01-14 07:56:39 -05:00

45 lines
1.3 KiB
C++

/*
* Copyright (C) 2019-present ScyllaDB
*/
/*
* SPDX-License-Identifier: LicenseRef-ScyllaDB-Source-Available-1.0
*/
#pragma once
#include "bytes_fwd.hh"
#include <memory>
/// Implements <code>text LIKE pattern</code>.
///
/// The pattern is a string of characters with two wildcards:
/// - '_' matches any single character
/// - '%' matches any substring (including an empty string)
/// - '\' escapes the next pattern character, so it matches verbatim
/// - any other pattern character matches itself
///
/// The whole text must match the pattern; thus <code>'abc' LIKE 'a'</code> doesn't match, but
/// <code>'abc' LIKE 'a%'</code> matches.
class like_matcher {
class impl;
std::unique_ptr<impl> _impl;
public:
/// Compiles \c pattern and stores the result.
///
/// \param pattern UTF-8 encoded pattern with wildcards '_' and '%'.
explicit like_matcher(bytes_view pattern);
like_matcher(like_matcher&&) noexcept; // Must be defined in .cc, where class impl is known.
~like_matcher();
/// Runs the compiled pattern on \c text.
///
/// \return true iff text matches constructor's pattern.
bool operator()(bytes_view text) const;
/// Resets pattern if different from the current one.
void reset(bytes_view pattern);
};