The C and C++ Include Header Files

/usr/include/c++/11/bits/regex_error.h


$ cat -n /usr/include/c++/11/bits/regex_error.h

     1	// class template regex -*- C++ -*-
     2	
     3	// Copyright (C) 2010-2021 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	
    33	namespace std _GLIBCXX_VISIBILITY(default)
    34	{
    35	_GLIBCXX_BEGIN_NAMESPACE_VERSION
    36	
    37	/**
    38	 * @addtogroup regex
    39	 * @{
    40	 */
    41	
    42	namespace 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