1// class template regex -*- C++ -*- 2 3// Copyright (C) 2010-2020 Free Software Foundation, Inc. 4// 5// This file is part of the GNU ISO C++ Library. This library is free 6// software; you can redistribute it and/or modify it under the 7// terms of the GNU General Public License as published by the 8// Free Software Foundation; either version 3, or (at your option) 9// any later version. 10 11// This library is distributed in the hope that it will be useful, 12// but WITHOUT ANY WARRANTY; without even the implied warranty of 13// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 14// GNU General Public License for more details. 15 16// Under Section 7 of GPL version 3, you are granted additional 17// permissions described in the GCC Runtime Library Exception, version 18// 3.1, as published by the Free Software Foundation. 19 20// You should have received a copy of the GNU General Public License and 21// a copy of the GCC Runtime Library Exception along with this program; 22// see the files COPYING3 and COPYING.RUNTIME respectively. If not, see 23// <http://www.gnu.org/licenses/>. 24 25/** 26 * @file bits/regex_error.h 27 * @brief Error and exception objects for the std regex library. 28 * 29 * This is an internal header file, included by other library headers. 30 * Do not attempt to use it directly. @headername{regex} 31 */ 32 33namespace std _GLIBCXX_VISIBILITY(default) 34{ 35_GLIBCXX_BEGIN_NAMESPACE_VERSION 36 37/** 38 * @addtogroup regex 39 * @{ 40 */ 41 42namespace regex_constants 43{ 44 /** 45 * @name 5.3 Error Types 46 */ 47 ///@{ 48 49 enum error_type 50 { 51 _S_error_collate, 52 _S_error_ctype, 53 _S_error_escape, 54 _S_error_backref, 55 _S_error_brack, 56 _S_error_paren, 57 _S_error_brace, 58 _S_error_badbrace, 59 _S_error_range, 60 _S_error_space, 61 _S_error_badrepeat, 62 _S_error_complexity, 63 _S_error_stack, 64 _S_null, 65 _S_grammar 66 }; 67 68 /** The expression contained an invalid collating element name. */ 69 constexpr error_type error_collate(_S_error_collate); 70 71 /** The expression contained an invalid character class name. */ 72 constexpr error_type error_ctype(_S_error_ctype); 73 74 /** 75 * The expression contained an invalid escaped character, or a trailing 76 * escape. 77 */ 78 constexpr error_type error_escape(_S_error_escape); 79 80 /** The expression contained an invalid back reference. */ 81 constexpr error_type error_backref(_S_error_backref); 82 83 /** The expression contained mismatched [ and ]. */ 84 constexpr error_type error_brack(_S_error_brack); 85 86 /** The expression contained mismatched ( and ). */ 87 constexpr error_type error_paren(_S_error_paren); 88 89 /** The expression contained mismatched { and } */ 90 constexpr error_type error_brace(_S_error_brace); 91 92 /** The expression contained an invalid range in a {} expression. */ 93 constexpr error_type error_badbrace(_S_error_badbrace); 94 95 /** 96 * The expression contained an invalid character range, 97 * such as [b-a] in most encodings. 98 */ 99 constexpr error_type error_range(_S_error_range); 100 101 /** 102 * There was insufficient memory to convert the expression into a 103 * finite state machine. 104 */ 105 constexpr error_type error_space(_S_error_space); 106 107 /** 108 * One of <em>*?+{</em> was not preceded by a valid regular expression. 109 */ 110 constexpr error_type error_badrepeat(_S_error_badrepeat); 111 112 /** 113 * The complexity of an attempted match against a regular expression 114 * exceeded a pre-set level. 115 */ 116 constexpr error_type error_complexity(_S_error_complexity); 117 118 /** 119 * There was insufficient memory to determine whether the 120 * regular expression could match the specified character sequence. 121 */ 122 constexpr error_type error_stack(_S_error_stack); 123 124 ///@} 125} // namespace regex_constants 126 127 // [7.8] Class regex_error 128 /** 129 * @brief A regular expression exception class. 130 * @ingroup exceptions 131 * 132 * The regular expression library throws objects of this class on error. 133 */ 134 class regex_error : public std::runtime_error 135 { 136 regex_constants::error_type _M_code; 137 138 public: 139 /** 140 * @brief Constructs a regex_error object. 141 * 142 * @param __ecode the regex error code. 143 */ 144 explicit 145 regex_error(regex_constants::error_type __ecode); 146 147 virtual ~regex_error() throw(); 148 149 /** 150 * @brief Gets the regex error code. 151 * 152 * @returns the regex error code. 153 */ 154 regex_constants::error_type 155 code() const noexcept 156 { return _M_code; } 157 158 private: 159 regex_error(regex_constants::error_type __ecode, const char* __what) 160 : std::runtime_error(__what), _M_code(__ecode) 161 { } 162 163 friend void __throw_regex_error(regex_constants::error_type, const char*); 164 }; 165 166 ///@} // group regex 167 168 void 169 __throw_regex_error(regex_constants::error_type __ecode); 170 171 inline void 172 __throw_regex_error(regex_constants::error_type __ecode 173 __attribute__((__unused__)), 174 const char* __what __attribute__((__unused__))) 175 { _GLIBCXX_THROW_OR_ABORT(regex_error(__ecode, __what)); } 176 177_GLIBCXX_END_NAMESPACE_VERSION 178} // namespace std 179