Shared constants/structs that are private to libpattern. More...

#include <stdbool.h>
#include "mutt/lib.h"
#include "email/lib.h"
#include "lib.h"

Include dependency graph for private.h:

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

Data Structures
struct	PatternFlags
	Mapping between user character and internal constant. More...

struct	RangeRegex
	Regular expression representing a range. More...

Macros
#define	RANGE_NUM_RX "([[:digit:]]+\|0x[[:xdigit:]]+)[MmKk]?"

#define	RANGE_REL_SLOT_RX "[[:blank:]]([.^$]\|-?" RANGE_NUM_RX ")?[[:blank:]]"

#define	RANGE_REL_RX "^" RANGE_REL_SLOT_RX "," RANGE_REL_SLOT_RX

#define	RANGE_ABS_SLOT_RX "[[:blank:]]([.^$]\|" RANGE_NUM_RX ")?[[:blank:]]"

#define	RANGE_ABS_RX "^" RANGE_ABS_SLOT_RX "-" RANGE_ABS_SLOT_RX

#define	RANGE_LT_RX "^()[[:blank:]](<[[:blank:]]" RANGE_NUM_RX ")[[:blank:]]*"

#define	RANGE_GT_RX "^()[[:blank:]](>[[:blank:]]" RANGE_NUM_RX ")[[:blank:]]*"

#define	RANGE_BARE_RX "^[[:blank:]]([.^$]\|" RANGE_NUM_RX ")[[:blank:]]"

#define	RANGE_RX_GROUPS 5

#define	RANGE_DOT '.'

#define	RANGE_CIRCUM '^'

#define	RANGE_DOLLAR '$'

#define	RANGE_LT '<'

#define	RANGE_GT '>'

#define	MUTT_MAXRANGE -1

Enumerations
enum	ExpandoDataPattern { ED_PAT_DESCRIPTION = 1 , ED_PAT_EXPRESSION , ED_PAT_NUMBER }
	Expando UIDs for Patterns. More...

enum	PatternEat { EAT_NONE , EAT_REGEX , EAT_DATE , EAT_RANGE , EAT_MESSAGE_RANGE , EAT_QUERY }
	Function to process pattern arguments. More...

enum	RangeType { RANGE_K_REL , RANGE_K_ABS , RANGE_K_LT , RANGE_K_GT , RANGE_K_BARE , RANGE_K_INVALID }
	Type of range. More...

enum	RangeSide { RANGE_S_LEFT , RANGE_S_RIGHT }
	Which side of the range. More...

Functions
static int	email_msgno (struct Email *e)
	Helper to get the Email's message number.

const struct PatternFlags *	lookup_op (int op)
	Lookup the Pattern Flags for an op.

const struct PatternFlags *	lookup_tag (char tag)
	Lookup a pattern modifier.

bool	eval_date_minmax (struct Pattern pat, const char s, struct Buffer *err)
	Evaluate a date-range pattern against 'now'.

bool	eat_message_range (struct Pattern pat, PatternCompFlags flags, struct Buffer s, struct Buffer err, struct MailboxView mv)
	Parse a range of message numbers - Implements eat_arg_t -.

Variables
struct RangeRegex	RangeRegexes []
	Set of Regexes for various range types.

const struct PatternFlags	Flags []
	Lookup table for all patterns.

Detailed Description

Shared constants/structs that are private to libpattern.

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 private.h.

Macro Definition Documentation

◆ RANGE_NUM_RX

#define RANGE_NUM_RX "([[:digit:]]+|0x[[:xdigit:]]+)[MmKk]?"

Definition at line 100 of file private.h.

◆ RANGE_REL_SLOT_RX

#define RANGE_REL_SLOT_RX "[[:blank:]]*([.^$]|-?" RANGE_NUM_RX ")?[[:blank:]]*"

Definition at line 101 of file private.h.

◆ RANGE_REL_RX

#define RANGE_REL_RX "^" RANGE_REL_SLOT_RX "," RANGE_REL_SLOT_RX

Definition at line 102 of file private.h.

◆ RANGE_ABS_SLOT_RX

#define RANGE_ABS_SLOT_RX "[[:blank:]]*([.^$]|" RANGE_NUM_RX ")?[[:blank:]]*"

Definition at line 105 of file private.h.

◆ RANGE_ABS_RX

#define RANGE_ABS_RX "^" RANGE_ABS_SLOT_RX "-" RANGE_ABS_SLOT_RX

Definition at line 106 of file private.h.

◆ RANGE_LT_RX

#define RANGE_LT_RX "^()[[:blank:]]*(<[[:blank:]]*" RANGE_NUM_RX ")[[:blank:]]*"

Definition at line 109 of file private.h.

◆ RANGE_GT_RX

#define RANGE_GT_RX "^()[[:blank:]]*(>[[:blank:]]*" RANGE_NUM_RX ")[[:blank:]]*"

Definition at line 110 of file private.h.

◆ RANGE_BARE_RX

#define RANGE_BARE_RX "^[[:blank:]]*([.^$]|" RANGE_NUM_RX ")[[:blank:]]*"

Definition at line 113 of file private.h.

◆ RANGE_RX_GROUPS

#define RANGE_RX_GROUPS 5

Definition at line 114 of file private.h.

◆ RANGE_DOT

#define RANGE_DOT '.'

Definition at line 116 of file private.h.

◆ RANGE_CIRCUM

#define RANGE_CIRCUM '^'

Definition at line 117 of file private.h.

◆ RANGE_DOLLAR

#define RANGE_DOLLAR '$'

Definition at line 118 of file private.h.

◆ RANGE_LT

#define RANGE_LT '<'

Definition at line 119 of file private.h.

◆ RANGE_GT

#define RANGE_GT '>'

Definition at line 120 of file private.h.

◆ MUTT_MAXRANGE

#define MUTT_MAXRANGE -1

Definition at line 141 of file private.h.

Enumeration Type Documentation

◆ ExpandoDataPattern

enum ExpandoDataPattern

Expando UIDs for Patterns.

See also: ED_PATTERN, ExpandoDomain

Enumerator
ED_PAT_DESCRIPTION	PatternEntry.desc.
ED_PAT_EXPRESSION	PatternEntry.expr.
ED_PAT_NUMBER	PatternEntry.num.

Definition at line 38 of file private.h.

{
  ED_PAT_DESCRIPTION = 1,      
  ED_PAT_EXPRESSION,           
  ED_PAT_NUMBER,               
};

◆ PatternEat

enum PatternEat

Function to process pattern arguments.

Values for PatternFlags.eat_arg

Enumerator
EAT_NONE	No arguments required.
EAT_REGEX	Process a regex.
EAT_DATE	Process a date (range)
EAT_RANGE	Process a number (range)
EAT_MESSAGE_RANGE	Process a message number (range)
EAT_QUERY	Process a query string.

Definition at line 50 of file private.h.

{
  EAT_NONE,          
  EAT_REGEX,         
  EAT_DATE,          
  EAT_RANGE,         
  EAT_MESSAGE_RANGE, 
  EAT_QUERY,         
};

◆ RangeType

enum RangeType

Type of range.

Enumerator
RANGE_K_REL	Relative range.
RANGE_K_ABS	Absolute range.
RANGE_K_LT	Less-than range.
RANGE_K_GT	Greater-than range.
RANGE_K_BARE	Single symbol.
RANGE_K_INVALID	Range is invalid.

Definition at line 88 of file private.h.

{
  RANGE_K_REL,  
  RANGE_K_ABS,  
  RANGE_K_LT,   
  RANGE_K_GT,   
  RANGE_K_BARE, 
  /* add new ones HERE */
  RANGE_K_INVALID, 
};

◆ RangeSide

enum RangeSide

Which side of the range.

Enumerator
RANGE_S_LEFT	Left side of range.
RANGE_S_RIGHT	Right side of range.

Definition at line 125 of file private.h.

{
  RANGE_S_LEFT,  
  RANGE_S_RIGHT, 
};

Function Documentation

◆ email_msgno()

static int email_msgno ( struct Email * e )

inlinestatic

Helper to get the Email's message number.

Parameters

e Email

Return values

num	Message number

Definition at line 136 of file private.h.

{
  return e->msgno + 1;
}

Here is the caller graph for this function:

◆ lookup_op()

const struct PatternFlags * lookup_op ( int op )

Lookup the Pattern Flags for an op.

Parameters

op	Operation, e.g. MUTT_PAT_SENDER

Return values

ptr	PatternFlags

Definition at line 211 of file flags.c.

{
  for (int i = 0; Flags[i].tag; i++)
    if (Flags[i].op == op)
      return (&Flags[i]);
  return NULL;
}

Here is the caller graph for this function:

◆ lookup_tag()

const struct PatternFlags * lookup_tag ( char tag )

Lookup a pattern modifier.

Parameters

tag	Letter, e.g. 'b' for pattern '~b'

Return values

ptr	Pattern data

Definition at line 198 of file flags.c.

{
  for (int i = 0; Flags[i].tag; i++)
    if (Flags[i].tag == tag)
      return &Flags[i];
  return NULL;
}

Here is the caller graph for this function:

◆ eval_date_minmax()

bool eval_date_minmax	(	struct Pattern *	pat,
		const char *	s,
		struct Buffer *	err
	)

Evaluate a date-range pattern against 'now'.

Parameters

pat	Pattern to modify
s	Pattern string to use
err	Buffer for error messages

Return values

true	Pattern valid and updated
false	Pattern invalid

Definition at line 494 of file compile.c.

{
  /* the '0' time is Jan 1, 1970 UTC, so in order to prevent a negative time
   * when doing timezone conversion, we use Jan 2, 1970 UTC as the base here */
  struct tm min = { 0 };
  min.tm_mday = 2;
  min.tm_year = 70;
 
  /* Arbitrary year in the future.  Don't set this too high or
   * mutt_date_make_time() returns something larger than will fit in a time_t
   * on some systems */
  struct tm max = { 0 };
  max.tm_year = 130;
  max.tm_mon = 11;
  max.tm_mday = 31;
  max.tm_hour = 23;
  max.tm_min = 59;
  max.tm_sec = 59;
 
  if (strchr("<>=", s[0]))
  {
    /* offset from current time
     *  <3d  less than three days ago
     *  >3d  more than three days ago
     *  =3d  exactly three days ago */
    struct tm *tm = NULL;
    bool exact = false;
 
    if (s[0] == '<')
    {
      min = mutt_date_localtime(mutt_date_now());
      tm = &min;
    }
    else
    {
      max = mutt_date_localtime(mutt_date_now());
      tm = &max;
 
      if (s[0] == '=')
        exact = true;
    }
 
    /* Reset the HMS unless we are relative matching using one of those
     * offsets. */
    char *offset_type = NULL;
    strtol(s + 1, &offset_type, 0);
    if (!(*offset_type && strchr("HMS", *offset_type)))
    {
      tm->tm_hour = 23;
      tm->tm_min = 59;
      tm->tm_sec = 59;
    }
 
    /* force negative offset */
    get_offset(tm, s + 1, -1);
 
    if (exact)
    {
      /* start at the beginning of the day in question */
      memcpy(&min, &max, sizeof(max));
      min.tm_hour = 0;
      min.tm_sec = 0;
      min.tm_min = 0;
    }
  }
  else
  {
    const char *pc = s;
 
    bool have_min = false;
    bool until_now = false;
    if (mutt_isdigit(*pc))
    {
      /* minimum date specified */
      pc = get_date(pc, &min, err);
      if (!pc)
      {
        return false;
      }
      have_min = true;
      SKIPWS(pc);
      if (*pc == '-')
      {
        const char *pt = pc + 1;
        SKIPWS(pt);
        until_now = (*pt == '\0');
      }
    }
 
    if (!until_now)
    { /* max date or relative range/window */
 
      struct tm base_min = { 0 };
 
      if (!have_min)
      { /* save base minimum and set current date, e.g. for "-3d+1d" */
        memcpy(&base_min, &min, sizeof(base_min));
        min = mutt_date_localtime(mutt_date_now());
        min.tm_hour = 0;
        min.tm_sec = 0;
        min.tm_min = 0;
      }
 
      /* preset max date for relative offsets,
       * if nothing follows we search for messages on a specific day */
      max.tm_year = min.tm_year;
      max.tm_mon = min.tm_mon;
      max.tm_mday = min.tm_mday;
 
      if (!parse_date_range(pc, &min, &max, have_min, &base_min, err))
      { /* bail out on any parsing error */
        return false;
      }
    }
  }
 
  /* Since we allow two dates to be specified we'll have to adjust that. */
  adjust_date_range(&min, &max);
 
  pat->min = mutt_date_make_time(&min, true);
  pat->max = mutt_date_make_time(&max, true);
 
  return true;
}

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

◆ RangeRegexes

struct RangeRegex RangeRegexes[]

extern

Set of Regexes for various range types.

This array, will also contain the compiled regexes.

Definition at line 62 of file pattern.c.

◆ Flags

const struct PatternFlags Flags[]

extern

Lookup table for all patterns.

Definition at line 40 of file flags.c.

Data Structures

Macros

Enumerations

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ RANGE_NUM_RX

◆ RANGE_REL_SLOT_RX

◆ RANGE_REL_RX

◆ RANGE_ABS_SLOT_RX

◆ RANGE_ABS_RX

◆ RANGE_LT_RX

◆ RANGE_GT_RX

◆ RANGE_BARE_RX

◆ RANGE_RX_GROUPS

◆ RANGE_DOT

◆ RANGE_CIRCUM

◆ RANGE_DOLLAR

◆ RANGE_LT

◆ RANGE_GT

◆ MUTT_MAXRANGE

Enumeration Type Documentation

◆ ExpandoDataPattern

◆ PatternEat

◆ RangeType

◆ RangeSide

Function Documentation

◆ email_msgno()

◆ lookup_op()

◆ lookup_tag()

◆ eval_date_minmax()

Variable Documentation

◆ RangeRegexes

◆ Flags