Localization library | |||||||||||||||||||||||||
Regular expressions library(C++11) | |||||||||||||||||||||||||
Formatting library(C++20) | |||||||||||||||||||||||||
Null-terminated sequence utilities | |||||||||||||||||||||||||
Byte strings | |||||||||||||||||||||||||
Multibyte strings | |||||||||||||||||||||||||
Wide strings | |||||||||||||||||||||||||
Primitive numeric conversions | |||||||||||||||||||||||||
| |||||||||||||||||||||||||
Text encoding identifications | |||||||||||||||||||||||||
|
Classes | ||||
(C++11) | ||||
(C++11) | ||||
(C++11) | ||||
Algorithms | ||||
(C++11) | ||||
(C++11) | ||||
(C++11) | ||||
Iterators | ||||
(C++11) | ||||
(C++11) | ||||
Exceptions | ||||
(C++11) | ||||
Traits | ||||
(C++11) | ||||
Constants | ||||
(C++11) | ||||
(C++11) | ||||
error_type (C++11) | ||||
Regex Grammar | ||||
(C++11) |
Defined in header <regex> | ||
using error_type=/* implementation-defined */; | (1) | (since C++11) |
constexpr error_type error_collate= /* unspecified */; constexpr error_type error_ctype= /* unspecified */; | (2) | (since C++11) (inline since C++17) |
error_type
is a type that describes errors that may occur during regular expression parsing.Contents |
Name | Explanation |
error_collate | the expression contains an invalid collating element name |
error_ctype | the expression contains an invalid character class name |
error_escape | the expression contains an invalid escaped character or a trailing escape |
error_backref | the expression contains an invalid back reference |
error_brack | the expression contains mismatched square brackets ('[' and']') |
error_paren | the expression contains mismatched parentheses ('(' and')') |
error_brace | the expression contains mismatched curly braces ('{' and'}') |
error_badbrace | the expression contains an invalid range in a{} expression |
error_range | the expression contains an invalid character range (e.g. [b-a]) |
error_space | there was not enough memory to convert the expression into a finite state machine |
error_badrepeat | '*','?','+' or'{' was not preceded by a valid regular expression |
error_complexity | the complexity of an attempted match exceeded a predefined level |
error_stack | there was not enough memory to perform a match |
Implements regular expressions checker:
#include <cstddef>#include <iomanip>#include <iostream>#include <regex>#include <sstream>#include <string> void regular_expression_checker(conststd::string& text,conststd::string& regex,const std::regex::flag_type flags){std::cout<<"Text: "<<std::quoted(text)<<'\n'<<"Regex: "<<std::quoted(regex)<<'\n'; try{conststd::regex re{regex, flags};constbool matched=std::regex_match(text, re); std::stringstream out; out<<(matched?"MATCH!\n":"DOES NOT MATCH!\n"); std::smatch m;if(std::regex_search(text, m, re);!m.empty()){ out<<"prefix = ["<< m.prefix().str().data()<<"]\n"; for(std::size_t i{}; i!= m.size();++i) out<<" m["<< i<<"] = ["<< m[i].str().data()<<"]\n"; out<<"suffix = ["<< m.suffix().str().data()<<"]\n";}std::cout<< out.str()<<'\n';}catch(std::regex_error& e){std::cout<<"Error: "<< e.what()<<".\n\n";}} int main(){constexpr std::regex::flag_type your_flags= std::regex::flag_type{0}// Choose one of the supported grammars:| std::regex::ECMAScript// | std::regex::basic// | std::regex::extended// | std::regex::awk// | std::regex::grep// | std::regex::egrep// Choose any of the next options:// | std::regex::icase// | std::regex::nosubs// | std::regex::optimize// | std::regex::collate// | std::regex::multiline; conststd::string your_text="Hello regular expressions.";conststd::string your_regex= R"(([a-zA-Z]+) ([a-z]+) ([a-z]+)\.)"; regular_expression_checker(your_text, your_regex, your_flags); regular_expression_checker("Invalid!", R"(((.)(.))", your_flags); regular_expression_checker("Invalid!", R"([.)", your_flags); regular_expression_checker("Invalid!", R"([.]{})", your_flags); regular_expression_checker("Invalid!", R"([1-0])", your_flags);}
Possible output:
Text: "Hello regular expressions."Regex: "([a-zA-Z]+) ([a-z]+) ([a-z]+)\\."MATCH!prefix = [] m[0] = [Hello regular expressions.] m[1] = [Hello] m[2] = [regular] m[3] = [expressions]suffix = [] Text: "Invalid!"Regex: "((.)(.)"Error: Mismatched '(' and ')' in regular expression. Text: "Invalid!"Regex: "[."Error: Unexpected character within '[...]' in regular expression. Text: "Invalid!"Regex: "[.]{}"Error: Invalid range in '{}' in regular expression. Text: "Invalid!"Regex: "[1-0]"Error: Invalid range in bracket expression..
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
DR | Applied to | Behavior as published | Correct behavior |
---|---|---|---|
LWG 2053 | C++11 | the constants were declaredstatic | removed thestatic specifier |
(C++11) | reports errors generated by the regular expressions library (class)[edit] |