31 Regular expressions library [re]

31.8 Class template basic_­regex [re.regex]

31.8.2 basic_­regex constructors [re.regex.construct]

basic_regex();
1
#
Effects: Constructs an object of class basic_­regex that does not match any character sequence.
explicit basic_regex(const charT* p, flag_type f = regex_constants::ECMAScript);
2
#
Requires: p shall not be a null pointer.
3
#
Throws: regex_­error if p is not a valid regular expression.
4
#
Effects: Constructs an object of class basic_­regex; the object's internal finite state machine is constructed from the regular expression contained in the array of charT of length char_­traits<charT>​::​​length(p) whose first element is designated by p, and interpreted according to the flags f.
5
#
Postconditions: flags() returns f.
mark_­count() returns the number of marked sub-expressions within the expression.
basic_regex(const charT* p, size_t len, flag_type f);
6
#
Requires: p shall not be a null pointer.
7
#
Throws: regex_­error if p is not a valid regular expression.
8
#
Effects: Constructs an object of class basic_­regex; the object's internal finite state machine is constructed from the regular expression contained in the sequence of characters [p, p+len), and interpreted according the flags specified in f.
9
#
Postconditions: flags() returns f.
mark_­count() returns the number of marked sub-expressions within the expression.
basic_regex(const basic_regex& e);
10
#
Effects: Constructs an object of class basic_­regex as a copy of the object e.
11
#
Postconditions: flags() and mark_­count() return e.flags() and e.mark_­count(), respectively.
basic_regex(basic_regex&& e) noexcept;
12
#
Effects: Move constructs an object of class basic_­regex from e.
13
#
Postconditions: flags() and mark_­count() return the values that e.flags() and e.mark_­count(), respectively, had before construction.
e is in a valid state with unspecified value.
template <class ST, class SA> explicit basic_regex(const basic_string<charT, ST, SA>& s, flag_type f = regex_constants::ECMAScript);
14
#
Throws: regex_­error if s is not a valid regular expression.
15
#
Effects: Constructs an object of class basic_­regex; the object's internal finite state machine is constructed from the regular expression contained in the string s, and interpreted according to the flags specified in f.
16
#
Postconditions: flags() returns f.
mark_­count() returns the number of marked sub-expressions within the expression.
template <class ForwardIterator> basic_regex(ForwardIterator first, ForwardIterator last, flag_type f = regex_constants::ECMAScript);
17
#
Throws: regex_­error if the sequence [first, last) is not a valid regular expression.
18
#
Effects: Constructs an object of class basic_­regex; the object's internal finite state machine is constructed from the regular expression contained in the sequence of characters [first, last), and interpreted according to the flags specified in f.
19
#
Postconditions: flags() returns f.
mark_­count() returns the number of marked sub-expressions within the expression.
basic_regex(initializer_list<charT> il, flag_type f = regex_constants::ECMAScript);
20
#
Effects: Same as basic_­regex(il.begin(), il.end(), f).