regex.c File Reference

Type representing a regular expression. More...

#include "config.h"
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
#include "mutt/lib.h"
#include "regex2.h"
#include "set.h"
#include "types.h"

Include dependency graph for regex.c:

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.
static void	regex_destroy (void *var, const struct ConfigDef *cdef)
	Destroy a Regex object - Implements ConfigSetType::destroy() -.
struct Regex *	regex_new (const char *str, uint32_t flags, struct Buffer *err)
	Create an Regex from a string.
static int	regex_string_set (void *var, struct ConfigDef *cdef, const char *value, struct Buffer *err)
	Set a Regex by string - Implements ConfigSetType::string_set() -.
static int	regex_string_get (void *var, const struct ConfigDef *cdef, struct Buffer *result)
	Get a Regex as a string - Implements ConfigSetType::string_get() -.
static int	regex_native_set (void *var, const struct ConfigDef *cdef, intptr_t value, struct Buffer *err)
	Set a Regex config item by Regex object - Implements ConfigSetType::native_set() -.
static intptr_t	regex_native_get (void *var, const struct ConfigDef *cdef, struct Buffer *err)
	Get a Regex object from a Regex config item - Implements ConfigSetType::native_get() -.
static bool	regex_has_been_set (void *var, const struct ConfigDef *cdef)
	Is the config value different to its initial value?
static int	regex_reset (void *var, const struct ConfigDef *cdef, struct Buffer *err)
	Reset a Regex to its initial value - Implements ConfigSetType::reset() -.

Variables
const struct ConfigSetType	CstRegex
	Config type representing a regular expression.

Detailed Description

Type representing a regular expression.

Authors

• Richard Russon
• Pietro Cerutti
• наб

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 regex.c.

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:

Variable Documentation

CstRegex

const struct ConfigSetType CstRegex

Initial value:

= {
  DT_REGEX,
  "regex",
  regex_string_set,
  regex_string_get,
  regex_native_set,
  regex_native_get,
  NULL, 
  NULL, 
  regex_has_been_set,
  regex_reset,
  regex_destroy,
}

Config type representing a regular expression.

Definition at line 345 of file regex.c.

                                      {
  DT_REGEX,
  "regex",
  regex_string_set,
  regex_string_get,
  regex_native_set,
  regex_native_get,
  NULL, // string_plus_equals
  NULL, // string_minus_equals
  regex_has_been_set,
  regex_reset,
  regex_destroy,
};