prex.h File Reference

Manage precompiled / predefined regular expressions. More...

#include <regex.h>

Include dependency graph for prex.h:

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

Go to the source code of this file.

Enumerations
enum	Prex {   PREX_URL , PREX_URL_QUERY_KEY_VAL , PREX_RFC2047_ENCODED_WORD , PREX_GNUTLS_CERT_HOST_HASH ,   PREX_RFC5322_DATE_LAX , PREX_IMAP_DATE , PREX_MBOX_FROM , PREX_MBOX_FROM_LAX ,   PREX_ACCOUNT_CMD , PREX_ALIAS_TAGS , PREX_MAX }
	Predefined list of regular expressions. More...
enum	PrexUrlSchemeMatch {   PREX_URL_MATCH_FULL , PREX_URL_MATCH_SCHEME , PREX_URL_MATCH_REST , PREX_URL_MATCH_AUTH_OR_PATH ,   PREX_URL_MATCH_AUTHORITY_PATH , PREX_URL_MATCH_USERINFO , PREX_URL_MATCH_USER , PREX_URL_MATCH_COLONPASS ,   PREX_URL_MATCH_PASS , PREX_URL_MATCH_HOST , PREX_URL_MATCH_HOSTNAME , PREX_URL_MATCH_HOSTIPVX ,   PREX_URL_MATCH_COLONPORT , PREX_URL_MATCH_PORT , PREX_URL_MATCH_SLASHPATH , PREX_URL_MATCH_PATH ,   PREX_URL_MATCH_PATH_ONLY , PREX_URL_MATCH_QUESTIONQUERY , PREX_URL_MATCH_QUERY , PREX_URL_MATCH_MAX }
	Regex Matches for PREX_URL. More...
enum	PrexUrlQueryKeyValMatch { PREX_URL_QUERY_KEY_VAL_MATCH_FULL , PREX_URL_QUERY_KEY_VAL_MATCH_KEY , PREX_URL_QUERY_KEY_VAL_MATCH_VAL , PREX_URL_QUERY_KEY_VAL_MATCH_MAX }
	Regex Matches for PREX_URL_QUERY_KEY_VAL. More...
enum	PrexRfc2047EncodedWordMatch {   PREX_RFC2047_ENCODED_WORD_MATCH_FULL , PREX_RFC2047_ENCODED_WORD_MATCH_CHARSET , PREX_RFC2047_ENCODED_WORD_MATCH_ENCODING , PREX_RFC2047_ENCODED_WORD_MATCH_TEXT ,   PREX_RFC2047_ENCODED_WORD_MATCH_MAX }
	Regex Matches for PREX_RFC2047_ENCODED_WORD. More...
enum	PrexGnuTlsCertHostnameMatch {   PREX_GNUTLS_CERT_HOST_HASH_MATCH_FULL , PREX_GNUTLS_CERT_HOST_HASH_MATCH_HOST , PREX_GNUTLS_CERT_HOST_HASH_MATCH_HASH , PREX_GNUTLS_CERT_HOST_HASH_MATCH_HASH_LAST ,   PREX_GNUTLS_CERT_HOST_HASH_MATCH_MAX }
	Regex Matches for a TLS Certificate Hostname. More...
enum	PrexRfc5322DateLax {   PREX_RFC5322_DATE_LAX_MATCH_FULL , PREX_RFC5322_DATE_LAX_MATCH_CFWS1 , PREX_RFC5322_DATE_LAX_MATCH_MAYBE_DOW , PREX_RFC5322_DATE_LAX_MATCH_DOW ,   PREX_RFC5322_DATE_LAX_MATCH_CFWS2 , PREX_RFC5322_DATE_LAX_MATCH_CFWS3 , PREX_RFC5322_DATE_LAX_MATCH_DAY , PREX_RFC5322_DATE_LAX_MATCH_CFWS4 ,   PREX_RFC5322_DATE_LAX_MATCH_MONTH , PREX_RFC5322_DATE_LAX_MATCH_CFWS5 , PREX_RFC5322_DATE_LAX_MATCH_YEAR , PREX_RFC5322_DATE_LAX_MATCH_CFWS6 ,   PREX_RFC5322_DATE_LAX_MATCH_HOUR , PREX_RFC5322_DATE_LAX_MATCH_CFWS7 , PREX_RFC5322_DATE_LAX_MATCH_MINUTE , PREX_RFC5322_DATE_LAX_MATCH_CFWS8 ,   PREX_RFC5322_DATE_LAX_MATCH_COLONSECOND , PREX_RFC5322_DATE_LAX_MATCH_CFWS9 , PREX_RFC5322_DATE_LAX_MATCH_SECOND , PREX_RFC5322_DATE_LAX_MATCH_CFWS10 ,   PREX_RFC5322_DATE_LAX_MATCH_TZFULL , PREX_RFC5322_DATE_LAX_MATCH_TZ , PREX_RFC5322_DATE_LAX_MATCH_TZ_OBS , PREX_RFC5322_DATE_LAX_MATCH_MAX }
	Regex Matches for a RFC5322 date, including obsolete comments in parentheses. More...
enum	PrexImapDate {   PREX_IMAP_DATE_MATCH_FULL , PREX_IMAP_DATE_MATCH_DAY , PREX_IMAP_DATE_MATCH_DAY1 , PREX_IMAP_DATE_MATCH_DAY2 ,   PREX_IMAP_DATE_MATCH_MONTH , PREX_IMAP_DATE_MATCH_YEAR , PREX_IMAP_DATE_MATCH_TIME , PREX_IMAP_DATE_MATCH_TZ ,   PREX_IMAP_DATE_MATCH_MAX }
	Regex matches for an IMAP INTERNALDATE. More...
enum	PrexMboxFrom {   PREX_MBOX_FROM_MATCH_FULL , PREX_MBOX_FROM_MATCH_ENVSENDER , PREX_MBOX_FROM_MATCH_DOW , PREX_MBOX_FROM_MATCH_MONTH ,   PREX_MBOX_FROM_MATCH_DAY , PREX_MBOX_FROM_MATCH_DAY1 , PREX_MBOX_FROM_MATCH_DAY2 , PREX_MBOX_FROM_MATCH_TIME ,   PREX_MBOX_FROM_MATCH_YEAR , PREX_MBOX_FROM_MATCH_MAX }
	Regex matches for an mbox-style From line. More...
enum	PrexMboxFromLax {   PREX_MBOX_FROM_LAX_MATCH_FULL , PREX_MBOX_FROM_LAX_MATCH_ENVSENDER , PREX_MBOX_FROM_LAX_MATCH_ENVSENDER_PIPER , PREX_MBOX_FROM_LAX_MATCH_DOW ,   PREX_MBOX_FROM_LAX_MATCH_MONTH , PREX_MBOX_FROM_LAX_MATCH_DAY , PREX_MBOX_FROM_LAX_MATCH_DAY1 , PREX_MBOX_FROM_LAX_MATCH_DAY2 ,   PREX_MBOX_FROM_LAX_MATCH_TIME , PREX_MBOX_FROM_LAX_MATCH_TIME_SEC , PREX_MBOX_FROM_LAX_MATCH_TIME_NOSEC , PREX_MBOX_FROM_LAX_MATCH_TZ ,   PREX_MBOX_FROM_LAX_MATCH_TZ1 , PREX_MBOX_FROM_LAX_MATCH_TZ2 , PREX_MBOX_FROM_LAX_MATCH_YEAR , PREX_MBOX_FROM_LAX_MATCH_YEAR_4DIG ,   PREX_MBOX_FROM_LAX_MATCH_YEAR_2DIG , PREX_MBOX_FROM_LAX_MATCH_MAX }
	Regex matches for an mbox-style From line, lax mode. More...
enum	PrexAccountCmd { PREX_ACCOUNT_CMD_MATCH_FULL , PREX_ACCOUNT_CMD_MATCH_KEY , PREX_ACCOUNT_CMD_MATCH_VALUE , PREX_ACCOUNT_CMD_MATCH_MAX }
	Regex matches for the output lines of account_command. More...
enum	PrexAliasTags {   PREX_ALIAS_TAGS_MATCH_FULL , PREX_ALIAS_TAGS_MATCH_PRE , PREX_ALIAS_TAGS_MATCH_KEY , PREX_ALIAS_TAGS_MATCH_TAGS ,   PREX_ALIAS_TAGS_MATCH_POST , PREX_ALIAS_TAGS_MATCH_MAX }
	Regex matches for the tags: field of an alias command. More...

Functions
regmatch_t *	mutt_prex_capture (enum Prex which, const char *str)
	Match a precompiled regex against a string.
void	mutt_prex_cleanup (void)
	Cleanup heap memory allocated by compiled regexes.

Detailed Description

Manage precompiled / predefined regular expressions.

Authors

• Pietro Cerutti
• 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 prex.h.

Enumeration Type Documentation

Prex

enum Prex

Predefined list of regular expressions.

Enumerator
PREX_URL	[imaps://user:pass@example.com/INBOX?foo=bar]
PREX_URL_QUERY_KEY_VAL	https://example.com/?[q=foo]
PREX_RFC2047_ENCODED_WORD	[=?utf-8?Q?=E8=81=AA=E6=98=8E=E7=9A=84?=]
PREX_GNUTLS_CERT_HOST_HASH	[#H foo.com A76D 954B EB79 1F49 5B3A 0A0E 0681 65B1]
PREX_RFC5322_DATE_LAX	[Mon, (Comment) 16 Mar 2020 15:09:35 -0700]
PREX_IMAP_DATE	[16-MAR-2020 15:09:35 -0700]
PREX_MBOX_FROM	[From god@heaven.af.mil Sat Jan 3 01:05:34 1996]
PREX_MBOX_FROM_LAX	[From god@heaven.af.mil Sat Jan 3 01:05:34 1996]
PREX_ACCOUNT_CMD	key: value
PREX_ALIAS_TAGS	tags:a,b,c
PREX_MAX

Definition at line 32 of file prex.h.

{
  PREX_URL,                   
  PREX_URL_QUERY_KEY_VAL,     
  PREX_RFC2047_ENCODED_WORD,  
  PREX_GNUTLS_CERT_HOST_HASH, 
  PREX_RFC5322_DATE_LAX,      
  PREX_IMAP_DATE,             
  PREX_MBOX_FROM,             
  PREX_MBOX_FROM_LAX,         
  PREX_ACCOUNT_CMD,           
  PREX_ALIAS_TAGS,            
  PREX_MAX
};

PrexUrlSchemeMatch

enum PrexUrlSchemeMatch

Regex Matches for PREX_URL.

Note

The []s show the matching path of the URL

Enumerator
PREX_URL_MATCH_FULL	[imaps://user:pass@host.comInbox?foo=bar]
PREX_URL_MATCH_SCHEME	[imaps]://...
PREX_URL_MATCH_REST	imaps:[//...]
PREX_URL_MATCH_AUTH_OR_PATH	imaps:[somepath]|[//me@example.com/Inbox]?foo=bar
PREX_URL_MATCH_AUTHORITY_PATH	imaps:[//me@example.com/Inbox]?foo=bar
PREX_URL_MATCH_USERINFO	...//[user:pass@]...
PREX_URL_MATCH_USER	...//[user]:pass@...
PREX_URL_MATCH_COLONPASS	...//user[:pass]@...
PREX_URL_MATCH_PASS	...//user:[pass]@...
PREX_URL_MATCH_HOST	imaps://...[host.com]...
PREX_URL_MATCH_HOSTNAME	imaps://...[host.com]...
PREX_URL_MATCH_HOSTIPVX	imaps://...[127.0.0.1]...
PREX_URL_MATCH_COLONPORT	imaps://host.com[:993]/...
PREX_URL_MATCH_PORT	imaps://host.com:[993]/...
PREX_URL_MATCH_SLASHPATH	...:993[/Inbox]
PREX_URL_MATCH_PATH	...:993/[Inbox]
PREX_URL_MATCH_PATH_ONLY	mailto:[me@example.com]?foo=bar
PREX_URL_MATCH_QUESTIONQUERY	...Inbox[?foo=bar&baz=value]
PREX_URL_MATCH_QUERY	...Inbox?[foo=bar&baz=value]
PREX_URL_MATCH_MAX

Definition at line 52 of file prex.h.

{
  PREX_URL_MATCH_FULL,           
  PREX_URL_MATCH_SCHEME,         
  PREX_URL_MATCH_REST,           
  PREX_URL_MATCH_AUTH_OR_PATH,   
  PREX_URL_MATCH_AUTHORITY_PATH, 
  PREX_URL_MATCH_USERINFO,       
  PREX_URL_MATCH_USER,           
  PREX_URL_MATCH_COLONPASS,      
  PREX_URL_MATCH_PASS,           
  PREX_URL_MATCH_HOST,           
  PREX_URL_MATCH_HOSTNAME,       
  PREX_URL_MATCH_HOSTIPVX,       
  PREX_URL_MATCH_COLONPORT,      
  PREX_URL_MATCH_PORT,           
  PREX_URL_MATCH_SLASHPATH,      
  PREX_URL_MATCH_PATH,           
  PREX_URL_MATCH_PATH_ONLY,      
  PREX_URL_MATCH_QUESTIONQUERY,  
  PREX_URL_MATCH_QUERY,          
  PREX_URL_MATCH_MAX,
};

PrexUrlQueryKeyValMatch

enum PrexUrlQueryKeyValMatch

Regex Matches for PREX_URL_QUERY_KEY_VAL.

Note

The []s show the matching path of the URL Query

Enumerator
PREX_URL_QUERY_KEY_VAL_MATCH_FULL	[key=val]
PREX_URL_QUERY_KEY_VAL_MATCH_KEY	[key]=val
PREX_URL_QUERY_KEY_VAL_MATCH_VAL	key=[val]
PREX_URL_QUERY_KEY_VAL_MATCH_MAX

Definition at line 81 of file prex.h.

{
  PREX_URL_QUERY_KEY_VAL_MATCH_FULL, 
  PREX_URL_QUERY_KEY_VAL_MATCH_KEY,  
  PREX_URL_QUERY_KEY_VAL_MATCH_VAL,  
  PREX_URL_QUERY_KEY_VAL_MATCH_MAX
};

PrexRfc2047EncodedWordMatch

enum PrexRfc2047EncodedWordMatch

Regex Matches for PREX_RFC2047_ENCODED_WORD.

Note

The []s show the matching path of the RFC2047-encoded word

Enumerator
PREX_RFC2047_ENCODED_WORD_MATCH_FULL	[=?utf-8?Q?=E8=81...?=]
PREX_RFC2047_ENCODED_WORD_MATCH_CHARSET	=?[utf-8]?Q?=E8=81...?=
PREX_RFC2047_ENCODED_WORD_MATCH_ENCODING	=?utf-8?[Q]?=E8=81...?=
PREX_RFC2047_ENCODED_WORD_MATCH_TEXT	=?utf-8?Q?[=E8=81...]?=
PREX_RFC2047_ENCODED_WORD_MATCH_MAX

Definition at line 94 of file prex.h.

{
  PREX_RFC2047_ENCODED_WORD_MATCH_FULL,     
  PREX_RFC2047_ENCODED_WORD_MATCH_CHARSET,  
  PREX_RFC2047_ENCODED_WORD_MATCH_ENCODING, 
  PREX_RFC2047_ENCODED_WORD_MATCH_TEXT,     
  PREX_RFC2047_ENCODED_WORD_MATCH_MAX
};

PrexGnuTlsCertHostnameMatch

enum PrexGnuTlsCertHostnameMatch

Regex Matches for a TLS Certificate Hostname.

Note

The []s show the matching path of the TLS Certificate Hostname

Enumerator
PREX_GNUTLS_CERT_HOST_HASH_MATCH_FULL	[#H foo.com A76D ... 65B1]
PREX_GNUTLS_CERT_HOST_HASH_MATCH_HOST	#H [foo.com] A76D ... 65B1
PREX_GNUTLS_CERT_HOST_HASH_MATCH_HASH	#H foo.com [A76D ... 65B1]
PREX_GNUTLS_CERT_HOST_HASH_MATCH_HASH_LAST	#H foo.com A76D ... [65B1]
PREX_GNUTLS_CERT_HOST_HASH_MATCH_MAX

Definition at line 108 of file prex.h.

{
  PREX_GNUTLS_CERT_HOST_HASH_MATCH_FULL,      
  PREX_GNUTLS_CERT_HOST_HASH_MATCH_HOST,      
  PREX_GNUTLS_CERT_HOST_HASH_MATCH_HASH,      
  PREX_GNUTLS_CERT_HOST_HASH_MATCH_HASH_LAST, 
  PREX_GNUTLS_CERT_HOST_HASH_MATCH_MAX
};

PrexRfc5322DateLax

enum PrexRfc5322DateLax

Regex Matches for a RFC5322 date, including obsolete comments in parentheses.

The reason we provide a regex for RFC5322 dates is that the regular parser is faster, while this one is more complete.

Note

The []s show the matching path of the RFC5322 date

The *_CFWS* constants match ()d comments with whitespace

Enumerator
PREX_RFC5322_DATE_LAX_MATCH_FULL	[Mon, 2 Mar 2020 14:32:55 +0200]
PREX_RFC5322_DATE_LAX_MATCH_CFWS1
PREX_RFC5322_DATE_LAX_MATCH_MAYBE_DOW	[Mon, ]2 Mar 2020 14:32:55 +0200
PREX_RFC5322_DATE_LAX_MATCH_DOW	[Mon], 2 Mar 2020 14:32:55 +0200
PREX_RFC5322_DATE_LAX_MATCH_CFWS2
PREX_RFC5322_DATE_LAX_MATCH_CFWS3
PREX_RFC5322_DATE_LAX_MATCH_DAY	Tue, [3] Mar 2020 14:32:55 +0200
PREX_RFC5322_DATE_LAX_MATCH_CFWS4
PREX_RFC5322_DATE_LAX_MATCH_MONTH	Tue, 3 [Jan] 2020 14:32:55 +0200
PREX_RFC5322_DATE_LAX_MATCH_CFWS5
PREX_RFC5322_DATE_LAX_MATCH_YEAR	Tue, 3 Mar [2020] 14:32:55 +0200
PREX_RFC5322_DATE_LAX_MATCH_CFWS6
PREX_RFC5322_DATE_LAX_MATCH_HOUR	Tue, 3 Mar 2020 [14]:32:55 +0200
PREX_RFC5322_DATE_LAX_MATCH_CFWS7
PREX_RFC5322_DATE_LAX_MATCH_MINUTE	Tue, 3 Mar 2020 14:[32]:55 +0200
PREX_RFC5322_DATE_LAX_MATCH_CFWS8
PREX_RFC5322_DATE_LAX_MATCH_COLONSECOND	Tue, 3 Mar 2020 14:32[:55] +0200
PREX_RFC5322_DATE_LAX_MATCH_CFWS9
PREX_RFC5322_DATE_LAX_MATCH_SECOND	Tue, 3 Mar 2020 14:32:[55] +0200
PREX_RFC5322_DATE_LAX_MATCH_CFWS10
PREX_RFC5322_DATE_LAX_MATCH_TZFULL	Tue, 3 Mar 2020 14:32:55[CET]
PREX_RFC5322_DATE_LAX_MATCH_TZ	Tue, 3 Mar 2020 14:32:55 [+0200]
PREX_RFC5322_DATE_LAX_MATCH_TZ_OBS	Tue, 3 Mar 2020 14:32:55[UT]
PREX_RFC5322_DATE_LAX_MATCH_MAX

Definition at line 127 of file prex.h.

{
  PREX_RFC5322_DATE_LAX_MATCH_FULL,        
  PREX_RFC5322_DATE_LAX_MATCH_CFWS1,
  PREX_RFC5322_DATE_LAX_MATCH_MAYBE_DOW,   
  PREX_RFC5322_DATE_LAX_MATCH_DOW,         
  PREX_RFC5322_DATE_LAX_MATCH_CFWS2,
  PREX_RFC5322_DATE_LAX_MATCH_CFWS3,
  PREX_RFC5322_DATE_LAX_MATCH_DAY,         
  PREX_RFC5322_DATE_LAX_MATCH_CFWS4,
  PREX_RFC5322_DATE_LAX_MATCH_MONTH,       
  PREX_RFC5322_DATE_LAX_MATCH_CFWS5,
  PREX_RFC5322_DATE_LAX_MATCH_YEAR,        
  PREX_RFC5322_DATE_LAX_MATCH_CFWS6,
  PREX_RFC5322_DATE_LAX_MATCH_HOUR,        
  PREX_RFC5322_DATE_LAX_MATCH_CFWS7,
  PREX_RFC5322_DATE_LAX_MATCH_MINUTE,      
  PREX_RFC5322_DATE_LAX_MATCH_CFWS8,
  PREX_RFC5322_DATE_LAX_MATCH_COLONSECOND, 
  PREX_RFC5322_DATE_LAX_MATCH_CFWS9,
  PREX_RFC5322_DATE_LAX_MATCH_SECOND,      
  PREX_RFC5322_DATE_LAX_MATCH_CFWS10,
  PREX_RFC5322_DATE_LAX_MATCH_TZFULL,      
  PREX_RFC5322_DATE_LAX_MATCH_TZ,          
  PREX_RFC5322_DATE_LAX_MATCH_TZ_OBS,      
  PREX_RFC5322_DATE_LAX_MATCH_MAX
};

PrexImapDate

enum PrexImapDate

Regex matches for an IMAP INTERNALDATE.

Note

The []s show the matching path of the IMAP date

Enumerator
PREX_IMAP_DATE_MATCH_FULL	[16-MAR-2020 15:09:35 -0700]
PREX_IMAP_DATE_MATCH_DAY	[ 4]-MAR-2020 15:09:35 -0700
PREX_IMAP_DATE_MATCH_DAY1	[4]-MAR-2020 15:09:35 -0700
PREX_IMAP_DATE_MATCH_DAY2	[15]-MAR-2020 15:09:35 -0700
PREX_IMAP_DATE_MATCH_MONTH	15-[MAR]-2020 15:09:35 -0700
PREX_IMAP_DATE_MATCH_YEAR	15-MAR-[2020] 15:09:35 -0700
PREX_IMAP_DATE_MATCH_TIME	15-MAR-2020 [15:09:35] -0700
PREX_IMAP_DATE_MATCH_TZ	15-MAR-2020 15:09:35 [-0700]
PREX_IMAP_DATE_MATCH_MAX

Definition at line 160 of file prex.h.

{
  PREX_IMAP_DATE_MATCH_FULL,   
  PREX_IMAP_DATE_MATCH_DAY,    
  PREX_IMAP_DATE_MATCH_DAY1,   
  PREX_IMAP_DATE_MATCH_DAY2,   
  PREX_IMAP_DATE_MATCH_MONTH,  
  PREX_IMAP_DATE_MATCH_YEAR,   
  PREX_IMAP_DATE_MATCH_TIME,   
  PREX_IMAP_DATE_MATCH_TZ,     
  PREX_IMAP_DATE_MATCH_MAX
};

PrexMboxFrom

enum PrexMboxFrom

Regex matches for an mbox-style From line.

Note

The []s show the matching path of the IMAP date

Enumerator
PREX_MBOX_FROM_MATCH_FULL	[From god@heaven.af.mil Sat Jan 3 01:05:34 1996]
PREX_MBOX_FROM_MATCH_ENVSENDER	From [god@heaven.af.mil] Sat Jan 3 01:05:34 1996
PREX_MBOX_FROM_MATCH_DOW	From god@heaven.af.mil [Sat] Jan 3 01:05:34 1996
PREX_MBOX_FROM_MATCH_MONTH	From god@heaven.af.mil Sat [Jan] 3 01:05:34 1996
PREX_MBOX_FROM_MATCH_DAY	From god@heaven.af.mil Sat Jan [ 3] 01:05:34 1996
PREX_MBOX_FROM_MATCH_DAY1	From god@heaven.af.mil Sat Jan [3] 01:05:34 1996
PREX_MBOX_FROM_MATCH_DAY2	From god@heaven.af.mil Sat Jan [10] 01:05:34 1996
PREX_MBOX_FROM_MATCH_TIME	From god@heaven.af.mil Sat Jan 10 [01:05:34] 1996
PREX_MBOX_FROM_MATCH_YEAR	From god@heaven.af.mil Sat Jan 10 01:05:34 [1996]
PREX_MBOX_FROM_MATCH_MAX

Definition at line 178 of file prex.h.

{
  PREX_MBOX_FROM_MATCH_FULL,      
  PREX_MBOX_FROM_MATCH_ENVSENDER, 
  PREX_MBOX_FROM_MATCH_DOW,       
  PREX_MBOX_FROM_MATCH_MONTH,     
  PREX_MBOX_FROM_MATCH_DAY,       
  PREX_MBOX_FROM_MATCH_DAY1,      
  PREX_MBOX_FROM_MATCH_DAY2,      
  PREX_MBOX_FROM_MATCH_TIME,      
  PREX_MBOX_FROM_MATCH_YEAR,      
  PREX_MBOX_FROM_MATCH_MAX
};

PrexMboxFromLax

enum PrexMboxFromLax

Regex matches for an mbox-style From line, lax mode.

Note

The []s show the matching path of the IMAP date

Enumerator
PREX_MBOX_FROM_LAX_MATCH_FULL	[From god@heaven.af.mil Sat Jan 3 01:05:34 1996]
PREX_MBOX_FROM_LAX_MATCH_ENVSENDER	From [god at heaven.af.mil] Sat Jan 3 01:05:34 1996
PREX_MBOX_FROM_LAX_MATCH_ENVSENDER_PIPER	From [god@heaven.af.mil] Sat Jan 3 01:05:34 1996
PREX_MBOX_FROM_LAX_MATCH_DOW	From god@heaven.af.mil [Sat] Jan 3 01:05:34 1996
PREX_MBOX_FROM_LAX_MATCH_MONTH	From god@heaven.af.mil Sat [Jan] 3 01:05:34 1996
PREX_MBOX_FROM_LAX_MATCH_DAY	From god@heaven.af.mil Sat Jan [ 3] 01:05:34 1996
PREX_MBOX_FROM_LAX_MATCH_DAY1	From god@heaven.af.mil Sat Jan [3] 01:05:34 1996
PREX_MBOX_FROM_LAX_MATCH_DAY2	From god@heaven.af.mil Sat Jan [10] 01:05:34 1996
PREX_MBOX_FROM_LAX_MATCH_TIME	From god@heaven.af.mil Sat Jan 10 [01:05:34] 1996
PREX_MBOX_FROM_LAX_MATCH_TIME_SEC	From god@heaven.af.mil Sat Jan 10 [01:05:34] 1996
PREX_MBOX_FROM_LAX_MATCH_TIME_NOSEC	From god@heaven.af.mil Sat Jan 10 [01:05] 1996
PREX_MBOX_FROM_LAX_MATCH_TZ	From god@heaven.af.mil Sat Jan 10 01:05:34 [MET DST] 1996
PREX_MBOX_FROM_LAX_MATCH_TZ1	From god@heaven.af.mil Sat Jan 10 01:05:34 [MET DST] 1996
PREX_MBOX_FROM_LAX_MATCH_TZ2	From god@heaven.af.mil Sat Jan 10 01:05:34 [+0000] 1996
PREX_MBOX_FROM_LAX_MATCH_YEAR	From god@heaven.af.mil Sat Jan 10 01:05:34 [1996]
PREX_MBOX_FROM_LAX_MATCH_YEAR_4DIG	From god@heaven.af.mil Sat Jan 10 01:05:34 [1996]
PREX_MBOX_FROM_LAX_MATCH_YEAR_2DIG	From god@heaven.af.mil Sat Jan 10 01:05:34 [96]
PREX_MBOX_FROM_LAX_MATCH_MAX

Definition at line 197 of file prex.h.

{
  PREX_MBOX_FROM_LAX_MATCH_FULL,            
  PREX_MBOX_FROM_LAX_MATCH_ENVSENDER,       
  PREX_MBOX_FROM_LAX_MATCH_ENVSENDER_PIPER, 
  PREX_MBOX_FROM_LAX_MATCH_DOW,             
  PREX_MBOX_FROM_LAX_MATCH_MONTH,           
  PREX_MBOX_FROM_LAX_MATCH_DAY,             
  PREX_MBOX_FROM_LAX_MATCH_DAY1,            
  PREX_MBOX_FROM_LAX_MATCH_DAY2,            
  PREX_MBOX_FROM_LAX_MATCH_TIME,            
  PREX_MBOX_FROM_LAX_MATCH_TIME_SEC,        
  PREX_MBOX_FROM_LAX_MATCH_TIME_NOSEC,      
  PREX_MBOX_FROM_LAX_MATCH_TZ,              
  PREX_MBOX_FROM_LAX_MATCH_TZ1,             
  PREX_MBOX_FROM_LAX_MATCH_TZ2,             
  PREX_MBOX_FROM_LAX_MATCH_YEAR,            
  PREX_MBOX_FROM_LAX_MATCH_YEAR_4DIG,       
  PREX_MBOX_FROM_LAX_MATCH_YEAR_2DIG,       
  PREX_MBOX_FROM_LAX_MATCH_MAX
};

PrexAccountCmd

enum PrexAccountCmd

Regex matches for the output lines of account_command.

Enumerator
PREX_ACCOUNT_CMD_MATCH_FULL	[key: value]
PREX_ACCOUNT_CMD_MATCH_KEY	[key]: value
PREX_ACCOUNT_CMD_MATCH_VALUE	key: [value]
PREX_ACCOUNT_CMD_MATCH_MAX

Definition at line 222 of file prex.h.

{
  PREX_ACCOUNT_CMD_MATCH_FULL,  
  PREX_ACCOUNT_CMD_MATCH_KEY,   
  PREX_ACCOUNT_CMD_MATCH_VALUE, 
  PREX_ACCOUNT_CMD_MATCH_MAX
};

PrexAliasTags

enum PrexAliasTags

Regex matches for the tags: field of an alias command.

Enumerator
PREX_ALIAS_TAGS_MATCH_FULL	[... tags:a,b,c ...]
PREX_ALIAS_TAGS_MATCH_PRE	[... ]tags:a,b,c ...
PREX_ALIAS_TAGS_MATCH_KEY	... [tags:]a,b,c ...
PREX_ALIAS_TAGS_MATCH_TAGS	... tags:[a,b,c] ...
PREX_ALIAS_TAGS_MATCH_POST	... tags:a,b,c[ ...]
PREX_ALIAS_TAGS_MATCH_MAX

Definition at line 233 of file prex.h.

{
  PREX_ALIAS_TAGS_MATCH_FULL,  
  PREX_ALIAS_TAGS_MATCH_PRE,   
  PREX_ALIAS_TAGS_MATCH_KEY,   
  PREX_ALIAS_TAGS_MATCH_TAGS,  
  PREX_ALIAS_TAGS_MATCH_POST,  
  PREX_ALIAS_TAGS_MATCH_MAX,
};

Function Documentation

mutt_prex_capture()

regmatch_t * mutt_prex_capture	(	enum Prex	which,
		const char *	str )

Match a precompiled regex against a string.

Parameters

which	Which regex to return
str	String to apply regex on

Return values

ptr	Pointer to an array of matched captures
NULL	Regex didn't match

Definition at line 301 of file prex.c.

{
  if (!str)
    return NULL;
 
  struct PrexStorage *h = prex(which);
#ifdef HAVE_PCRE2
  size_t len = strlen(str);
  int rc = pcre2_match(h->re, (PCRE2_SPTR8) str, len, 0, 0, h->mdata, NULL);
  if (rc < 0)
  {
    PCRE2_UCHAR errmsg[1024];
    pcre2_get_error_message(rc, errmsg, sizeof(errmsg));
    mutt_debug(LL_DEBUG2, "pcre2_match - <%s> -> <%s> =  %s\n", h->str, str, errmsg);
    return NULL;
  }
  PCRE2_SIZE *ovector = pcre2_get_ovector_pointer(h->mdata);
  int i = 0;
  for (; i < rc; i++)
  {
    h->matches[i].rm_so = ovector[i * 2];
    h->matches[i].rm_eo = ovector[i * 2 + 1];
  }
  for (; i < h->nmatches; i++)
  {
    h->matches[i].rm_so = -1;
    h->matches[i].rm_eo = -1;
  }
#else
  if (regexec(h->re, str, h->nmatches, h->matches, 0))
    return NULL;
 
  ASSERT((h->re->re_nsub == (h->nmatches - 1)) &&
         "Regular expression and matches enum are out of sync");
#endif
  return h->matches;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_prex_cleanup()

void mutt_prex_cleanup

(

void

)

Cleanup heap memory allocated by compiled regexes.

Definition at line 342 of file prex.c.

{
  for (enum Prex which = 0; which < PREX_MAX; which++)
  {
    struct PrexStorage *h = prex(which);
#ifdef HAVE_PCRE2
    pcre2_match_data_free(h->mdata);
    pcre2_code_free(h->re);
#else
    regfree(h->re);
    FREE(&h->re);
#endif
    FREE(&h->matches);
  }
}

Here is the call graph for this function:

Here is the caller graph for this function: