summaryrefslogtreecommitdiffstats
path: root/src/util/sss_regexp.h
blob: 2b29361b373da8aa97e05855af407bc330505c0a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
/*
    SSSD

    Authors:
        Tomas Halman <thalman@redhat.com>

    Copyright (C) 2018 Red Hat

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.
*/

#ifndef SSS_REGEXP_H_
#define SSS_REGEXP_H_

#include <stddef.h>
#include <talloc.h>
#include "config.h"

/* regexp class */
typedef struct _sss_regexp_t sss_regexp_t;

#include <pcre2.h>
#define SSS_REGEXP_ERROR_NOMATCH  PCRE2_ERROR_NOMATCH
#define SSS_REGEXP_ERROR_NOMEMORY PCRE2_ERROR_NOMEMORY
#define SSS_REGEXP_NOTEMPTY       PCRE2_NOTEMPTY
#define SSS_REGEXP_EXTENDED       PCRE2_EXTENDED
#define SSS_REGEXP_DUPNAMES       PCRE2_DUPNAMES

/* how to use sss_regexp:
 *
 *  int err;
 *  const char *found;
 *
 *  sss_regexp_t *re
 *  err = sss_regexp_new (NULL, "#(?P<myname>.+)#", 0, &re);
 *  if (err != EOK) {
 *      goto fail;
 *  }
 *  int rc = sss_regexp_match (re,
 *                             "a#findthis#b",
 *                             0,
 *                             0);
 *  if (rc != 0) { ... }
 *  rc = sss_regexp_get_named_substring (re, "myname", &found);
 *  ...
 *  talloc_free (re);
 */

/*
 * Create new compiled regexp object.
 */
int sss_regexp_new(TALLOC_CTX *mem_ctx,
                   const char *pattern,
                   int options,
                   sss_regexp_t **self_p);

/*
 * Search subject with previously created regexp.
 */
int sss_regexp_match(sss_regexp_t *self,
                     const char *subject,
                     int startoffset,
                     int options);

/*
 * Get named substring from last sss_regexp_match.
 */
int sss_regexp_get_named_substring(sss_regexp_t *self,
                                   const char *name,
                                   const char **value);

#endif /* SSS_REGEXP_H_ */