regex2.h File Reference

Type representing a regular expression. More...

#include <stdbool.h>
#include <stdint.h>

Include dependency graph for regex2.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
bool	regex_equal (const struct Regex *a, const struct Regex *b)
	Compare two regexes.
void	regex_free (struct Regex **ptr)
	Free a Regex object.
struct Regex *	regex_new (const char *str, uint32_t flags, struct Buffer *err)
	Create an Regex from a string.

Detailed Description

Type representing a regular expression.

Authors

• Richard Russon

Copyright

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 2 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/.

Definition in file regex2.h.

Function Documentation

regex_equal()

bool regex_equal	(	const struct Regex *	a,
		const struct Regex *	b
	)

Compare two regexes.

Parameters

a	First regex
b	Second regex

Return values

true	They are identical

Definition at line 52 of file regex.c.

{
  if (!a && !b) /* both empty */
    return true;
  if (!a ^ !b) /* one is empty, but not the other */
    return false;
  if (a->pat_not != b->pat_not)
    return false;
 
  return mutt_str_equal(a->pattern, b->pattern);
}

Here is the call graph for this function:

Here is the caller graph for this function:

regex_free()

void regex_free

(

struct Regex **

ptr

)

Free a Regex object.

Parameters

[out]

ptr

Regex to free

Definition at line 68 of file regex.c.

{
  if (!ptr || !*ptr)
    return;
 
  struct Regex *rx = *ptr;
  FREE(&rx->pattern);
  if (rx->regex)
    regfree(rx->regex);
  FREE(&rx->regex);
 
  FREE(ptr);
}

Here is the caller graph for this function:

regex_new()

struct Regex * regex_new	(	const char *	str,
		uint32_t	flags,
		struct Buffer *	err
	)

Create an Regex from a string.

Parameters

str	Regular expression
flags	Type flags, e.g. D_REGEX_MATCH_CASE
err	Buffer for error messages

Return values

ptr	New Regex object
NULL	Error

Definition at line 102 of file regex.c.

{
  if (!str)
    return NULL;
 
  int rflags = 0;
  struct Regex *reg = MUTT_MEM_CALLOC(1, struct Regex);
 
  reg->regex = MUTT_MEM_CALLOC(1, regex_t);
  reg->pattern = mutt_str_dup(str);
 
  /* Should we use smart case matching? */
  if (((flags & D_REGEX_MATCH_CASE) == 0) && mutt_mb_is_lower(str))
    rflags |= REG_ICASE;
 
  if ((flags & D_REGEX_NOSUB))
    rflags |= REG_NOSUB;
 
  /* Is a prefix of '!' allowed? */
  if (((flags & D_REGEX_ALLOW_NOT) != 0) && (str[0] == '!'))
  {
    reg->pat_not = true;
    str++;
  }
 
  int rc = REG_COMP(reg->regex, str, rflags);
  if (rc != 0)
  {
    if (err)
      regerror(rc, reg->regex, err->data, err->dsize);
    regex_free(&reg);
    return NULL;
  }
 
  return reg;
}

Here is the call graph for this function:

Here is the caller graph for this function: