GDB: Add ChangeLog entry inadvertently omitted from commit.
[external/binutils.git] / gdb / gdb_regex.h
1 /* Portable <regex.h>.
2    Copyright (C) 2000-2018 Free Software Foundation, Inc.
3
4    This file is part of GDB.
5
6    This program is free software; you can redistribute it and/or modify
7    it under the terms of the GNU General Public License as published by
8    the Free Software Foundation; either version 3 of the License, or
9    (at your option) any later version.
10
11    This program 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    You should have received a copy of the GNU General Public License
17    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
18
19 #ifndef GDB_REGEX_H
20 #define GDB_REGEX_H 1
21
22 #ifdef USE_INCLUDED_REGEX
23 # include "xregex.h"
24 #else
25 /* Request 4.2 BSD regex functions.  */
26 # define _REGEX_RE_COMP
27 # include <regex.h>
28 #endif
29
30 /* A compiled regex.  This is mainly a wrapper around regex_t.  The
31    the constructor throws on regcomp error and the destructor is
32    responsible for calling regfree.  The former means that it's not
33    possible to create an instance of compiled_regex that isn't
34    compiled, hence the name.  */
35 class compiled_regex
36 {
37 public:
38   /* Compile a regexp and throw an exception on error, including
39      MESSAGE.  REGEX and MESSAGE must not be NULL.  */
40   compiled_regex (const char *regex, int cflags,
41                   const char *message)
42     ATTRIBUTE_NONNULL (2) ATTRIBUTE_NONNULL (4);
43
44   ~compiled_regex ();
45
46   DISABLE_COPY_AND_ASSIGN (compiled_regex);
47
48   /* Wrapper around ::regexec.  */
49   int exec (const char *string,
50             size_t nmatch, regmatch_t pmatch[],
51             int eflags) const;
52
53   /* Wrapper around ::re_search.  (Not const because re_search's
54      regex_t parameter isn't either.)  */
55   int search (const char *string, int size, int startpos,
56               int range, struct re_registers *regs);
57
58 private:
59   /* The compiled pattern.  */
60   regex_t m_pattern;
61 };
62
63 #endif /* not GDB_REGEX_H */