regex.hpp File Reference

real::compat — a std::regex-compatible drop-in (<regex> surface), char path. More...

#include "regex_core.hpp"
#include "regex_match.hpp"
#include "regex_iter.hpp"

Include dependency graph for regex.hpp:

Go to the source code of this file.

Detailed Description

real::compat — a std::regex-compatible drop-in (<regex> surface), char path.

The umbrella header: it includes the three parts below; #include <real/std/regex.hpp> is the one public entry point. The real::compat API is split purely organizationally — std/regex_core.hpp (constants, error, backend-routing screens, basic_regex), std/regex_match.hpp (sub_match, match_results, the runner, and the regex_search / regex_match / regex_replace free functions), and std/regex_iter.hpp (regex_iterator, regex_token_iterator).

Contract: behave identically to std::regex (ECMAScript) where real can prove it, and fall back to std::regex everywhere else — never a silent divergence. A pattern is run on real (linear-time, ReDoS-safe) when possible; backreferences, unbounded/oversized lookarounds, POSIX classes, non-ASCII inside [...], and the non-ECMAScript grammars route to std::regex via a compile-time screen plus a compile-failure catch.

real is always built with flags::bytes | flags::ecma so its byte-oriented, ECMAScript-$, ECMAScript-. semantics align with std::basic_regex<char> (validated by a differential).

Surface: basic_regex / sub_match / match_results / regex_error, regex_search, regex_match, regex_replace, regex_iterator / regex_token_iterator, the full match_flag_type, and wregex + POSIX grammars + nosubs. real runs only the char / default-traits / ECMAScript / every-group path (see detail::real_eligible); wide CharT, custom traits, POSIX/collate, and nosubs are always std. regex_replace/iterators route nullable patterns to std::regex (the empty-match traversal differs from ECMAScript, see basic_regex::nullable), and a constraining match_flag routes that operation to std.

See the "Drop-in for std::regex" migration guide and the compatibility reference (COMPATIBILITY.md) in the rendered documentation.

Definition in file regex.hpp.