Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/regex/basic regex/constants"

From cppreference.com
< cpp‎ | regex‎ | basic regex
m (Update links.)
m (fmt)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{cpp/title | basic_regex constants}}
+
{{cpp/title|basic_regex constants}}
 
{{cpp/regex/basic_regex/navbar}}
 
{{cpp/regex/basic_regex/navbar}}
  
 
{{dcl begin}}
 
{{dcl begin}}
{{dcl header | regex}}
+
{{dcl header|regex}}
{{dcl | 1=
+
{{dcl|1=
 
static constexpr std::regex_constants::syntax_option_type icase =
 
static constexpr std::regex_constants::syntax_option_type icase =
 
     std::regex_constants::icase;
 
     std::regex_constants::icase;
Line 25: Line 25:
 
static constexpr std::regex_constants::syntax_option_type egrep =
 
static constexpr std::regex_constants::syntax_option_type egrep =
 
     std::regex_constants::egrep;
 
     std::regex_constants::egrep;
 +
}}
 +
{{dcl|since=c++17|1=
 +
static constexpr std::regex_constants::syntax_option_type multiline =
 +
    std::regex_constants::multiline;
 
}}
 
}}
 
{{dcl end}}
 
{{dcl end}}
Line 36: Line 40:
 
===See also===
 
===See also===
 
{{dsc begin}}
 
{{dsc begin}}
{{dsc inc | cpp/regex/dsc syntax_option_type}}
+
{{dsc inc|cpp/regex/dsc syntax_option_type}}
 
{{dsc end}}
 
{{dsc end}}
  
[[de:cpp/regex/basic regex/constants]]
+
{{langlinks|de|es|fr|it|ja|pt|ru|zh}}
[[es:cpp/regex/basic regex/constants]]
+
[[fr:cpp/regex/basic regex/constants]]
+
[[it:cpp/regex/basic regex/constants]]
+
[[ja:cpp/regex/basic regex/constants]]
+
[[pt:cpp/regex/basic regex/constants]]
+
[[ru:cpp/regex/basic regex/constants]]
+
[[zh:cpp/regex/basic regex/constants]]
+

Latest revision as of 22:48, 20 October 2023

Defined in header <regex>
static constexpr std::regex_constants::syntax_option_type icase =

    std::regex_constants::icase;
static constexpr std::regex_constants::syntax_option_type nosubs =
    std::regex_constants::nosubs;
static constexpr std::regex_constants::syntax_option_type optimize =
    std::regex_constants::optimize;
static constexpr std::regex_constants::syntax_option_type collate =
    std::regex_constants::collate;
static constexpr std::regex_constants::syntax_option_type ECMAScript =
    std::regex_constants::ECMAScript;
static constexpr std::regex_constants::syntax_option_type basic =
    std::regex_constants::basic;
static constexpr std::regex_constants::syntax_option_type extended =
    std::regex_constants::extended;
static constexpr std::regex_constants::syntax_option_type awk =
    std::regex_constants::awk;
static constexpr std::regex_constants::syntax_option_type grep =
    std::regex_constants::grep;
static constexpr std::regex_constants::syntax_option_type egrep =

    std::regex_constants::egrep;
(since C++17)

std::basic_regex defines several constants that govern general regex matching syntax.

These constants are duplicated from std::regex_constants:

Grammar option Effect(s)
ECMAScript Use the Modified ECMAScript regular expression grammar.
basic Use the basic POSIX regular expression grammar (grammar documentation).
extended Use the extended POSIX regular expression grammar (grammar documentation).
awk Use the regular expression grammar used by the awk utility in POSIX (grammar documentation).
grep Use the regular expression grammar used by the grep utility in POSIX. This is effectively the same as the basic option with the addition of newline '\n' as an alternation separator.
egrep Use the regular expression grammar used by the grep utility, with the -E option, in POSIX. This is effectively the same as the extended option with the addition of newline '\n' as an alternation separator in addition to '|'.
Grammar variation Effect(s)
icase Character matching should be performed without regard to case.
nosubs When performing matches, all marked sub-expressions (expr) are treated as non-marking sub-expressions (?:expr). No matches are stored in the supplied std::regex_match structure and mark_count() is zero.
optimize Instructs the regular expression engine to make matching faster, with the potential cost of making construction slower. For example, this might mean converting a non-deterministic FSA to a deterministic FSA.
collate Character ranges of the form "[a-b]" will be locale sensitive.
multiline (C++17) Specifies that ^ shall match the beginning of a line and $ shall match the end of a line, if the ECMAScript engine is selected.

At most one grammar option can be chosen out of ECMAScript, basic, extended, awk, grep, egrep. If no grammar is chosen, ECMAScript is assumed to be selected. The other options serve as variations, such that std::regex("meow", std::regex::icase) is equivalent to std::regex("meow", std::regex::ECMAScript|std::regex::icase).

[edit] See also

general options controlling regex behavior
(typedef) [edit]