regex.hpp

Go to the documentation of this file.

#pragma once
 
/// @file userver/utils/regex.hpp
/// @brief @copybrief utils::regex
 
#include <string>
 
#include <userver/utils/fast_pimpl.hpp>
 
USERVER_NAMESPACE_BEGIN
 
namespace utils {
 
class match_results;
 
/// @ingroup userver_universal userver_containers
///
/// @brief Small alias for boost::regex / std::regex without huge includes
class regex final {
 public:
  regex();
  explicit regex(std::string_view pattern);
 
  ~regex();
 
  regex(const regex&);
  regex(regex&&) noexcept;
 
  regex& operator=(const regex&);
  regex& operator=(regex&&) noexcept;
 
  bool operator==(const regex&) const;
 
  std::string str() const;
 
 private:
  struct Impl;
  utils::FastPimpl<Impl, 16, 8> impl_;
 
  friend class match_results;
  friend bool regex_match(std::string_view str, const regex& pattern);
  friend bool regex_match(std::string_view str, match_results& m,
                          const regex& pattern);
  friend bool regex_search(std::string_view str, const regex& pattern);
  friend bool regex_search(std::string_view str, match_results& m,
                           const regex& pattern);
  friend std::string regex_replace(std::string_view str, const regex& pattern,
                                   std::string_view repl);
};
 
/// @ingroup userver_universal userver_containers
///
/// @brief Small alias for boost::smatch / std::regex without huge includes
class match_results final {
 public:
  match_results();
 
  ~match_results();
 
  match_results(const match_results&);
 
  match_results& operator=(const match_results&);
 
  std::size_t size() const;
  std::string_view operator[](int sub) const;
 
 private:
  struct Impl;
  utils::FastPimpl<Impl, 80, 8> impl_;
 
  friend bool regex_match(std::string_view str, const regex& pattern);
  friend bool regex_match(std::string_view str, match_results& m,
                          const regex& pattern);
  friend bool regex_search(std::string_view str, const regex& pattern);
  friend bool regex_search(std::string_view str, match_results& m,
                           const regex& pattern);
  friend std::string regex_replace(std::string_view str, const regex& pattern,
                                   std::string_view repl);
};
 
/// @brief Determines whether the regular expression matches the entire target
/// character sequence
bool regex_match(std::string_view str, const regex& pattern);
 
/// @brief Returns true if the specified regular expression matches
/// the whole of the input. Fills in what matched in m.
bool regex_match(std::string_view str, match_results& m, const regex& pattern);
 
/// @brief Determines whether the regular expression matches anywhere in the
/// target character sequence. Fills in what matched in m
bool regex_search(std::string_view str, match_results& m, const regex& pattern);
 
/// @brief Determines whether the regular expression matches anywhere in the
/// target character sequence
bool regex_search(std::string_view str, const regex& pattern);
 
/// @brief Create a new string where all regular expression matches replaced
/// with repl
std::string regex_replace(std::string_view str, const regex& pattern,
                          std::string_view repl);
 
}  // namespace utils
 
USERVER_NAMESPACE_END