Expando Parse API

Custom function to parse a format string into a Node. More...

Functions
struct ExpandoNode *	parse_folder_date (const char *str, struct ExpandoFormat *fmt, int did, int uid, ExpandoParserFlags flags, const char **parsed_until, struct ExpandoParseError *err)
	Parse a Date Expando - Implements ExpandoDefinition::parse() -.
struct ExpandoNode *	node_padding_parse (const char *str, struct ExpandoFormat *fmt, int did, int uid, ExpandoParserFlags flags, const char **parsed_until, struct ExpandoParseError *err)
	Parse a Padding Expando - Implements ExpandoDefinition::parse() -.
struct ExpandoNode *	parse_index_date_recv_local (const char *str, struct ExpandoFormat *fmt, int did, int uid, ExpandoParserFlags flags, const char **parsed_until, struct ExpandoParseError *err)
	Parse a Date Expando - Implements ExpandoDefinition::parse() -.
struct ExpandoNode *	parse_index_date_local (const char *str, struct ExpandoFormat *fmt, int did, int uid, ExpandoParserFlags flags, const char **parsed_until, struct ExpandoParseError *err)
	Parse a Date Expando - Implements ExpandoDefinition::parse() -.
struct ExpandoNode *	parse_index_date (const char *str, struct ExpandoFormat *fmt, int did, int uid, ExpandoParserFlags flags, const char **parsed_until, struct ExpandoParseError *err)
	Parse a Date Expando - Implements ExpandoDefinition::parse() -.
struct ExpandoNode *	parse_index_hook (const char *str, struct ExpandoFormat *fmt, int did, int uid, ExpandoParserFlags flags, const char **parsed_until, struct ExpandoParseError *err)
	Parse an index-hook - Implements ExpandoDefinition::parse() -.
struct ExpandoNode *	parse_tags_transformed (const char *str, struct ExpandoFormat *fmt, int did, int uid, ExpandoParserFlags flags, const char **parsed_until, struct ExpandoParseError *err)
	Parse a Tags-Transformed Expando - Implements ExpandoDefinition::parse() -.
struct ExpandoNode *	parse_subject (const char *str, struct ExpandoFormat *fmt, int did, int uid, ExpandoParserFlags flags, const char **parsed_until, struct ExpandoParseError *err)
	Parse a Subject Expando - Implements ExpandoDefinition::parse() -.
struct ExpandoNode *	parse_pgp_date (const char *str, struct ExpandoFormat *fmt, int did, int uid, ExpandoParserFlags flags, const char **parsed_until, struct ExpandoParseError *err)
	Parse a Date Expando - Implements ExpandoDefinition::parse() -.

Detailed Description

Custom function to parse a format string into a Node.

Parameters

[in]	str	String to parse
[in]	fmt	Formatting information
[in]	did	Domain ID of the data
[in]	uid	Unique ID of the data
[in]	flags	Flags, e.g. EP_CONDITIONAL
[out]	parsed_until	First character after the parsed string
[out]	err	Buffer for error message

Return values

ptr	Parsed Node

Function Documentation

parse_folder_date()

struct ExpandoNode * parse_folder_date	(	const char *	str,
		struct ExpandoFormat *	fmt,
		int	did,
		int	uid,
		ExpandoParserFlags	flags,
		const char **	parsed_until,
		struct ExpandoParseError *	err
	)

Parse a Date Expando - Implements ExpandoDefinition::parse() -.

Parse a custom Expando of the form, "%[string]". The "string" will be passed to strftime().

Definition at line 62 of file config.c.

{
  if (flags & EP_CONDITIONAL)
  {
    return node_conddate_parse(str, did, uid, parsed_until, err);
  }
 
  return node_expando_parse_enclosure(str, did, uid, ']', fmt, parsed_until, err);
}

Here is the call graph for this function:

node_padding_parse()

struct ExpandoNode * node_padding_parse	(	const char *	str,
		struct ExpandoFormat *	fmt,
		int	did,
		int	uid,
		ExpandoParserFlags	flags,
		const char **	parsed_until,
		struct ExpandoParseError *	err
	)

Parse a Padding Expando - Implements ExpandoDefinition::parse() -.

Parse a Padding Expando of the form, "%|X", "%>X" or "%*X", where the character 'X' will be used to fill the space.

Definition at line 234 of file node_padding.c.

{
  if (fmt)
  {
    // L10N: Padding expandos, %* %> %|, don't use formatting, e.g. %-30x
    snprintf(err->message, sizeof(err->message), _("Padding cannot be formatted"));
    err->position = str;
    return NULL;
  }
 
  if (flags & EP_CONDITIONAL)
  {
    snprintf(err->message, sizeof(err->message),
             // L10N: Conditional Expandos can only depend on other Expandos
             //       e.g. "%<X?apple>" displays "apple" if "%X" is true.
             _("Padding cannot be used as a condition"));
    err->position = str;
    return NULL;
  }
 
  enum ExpandoPadType pt = 0;
  if (*str == '|')
  {
    pt = EPT_FILL_EOL;
  }
  else if (*str == '>')
  {
    pt = EPT_HARD_FILL;
  }
  else if (*str == '*')
  {
    pt = EPT_SOFT_FILL;
  }
  else
  {
    return NULL;
  }
  str++;
 
  size_t consumed = mutt_mb_charlen(str, NULL);
  if (consumed == 0)
  {
    str = " "; // Default to a space
    consumed = 1;
  }
 
  *parsed_until = str + consumed;
  return node_padding_new(pt, str, str + consumed);
}

Here is the call graph for this function:

parse_index_date_recv_local()

struct ExpandoNode * parse_index_date_recv_local	(	const char *	str,
		struct ExpandoFormat *	fmt,
		int	did,
		int	uid,
		ExpandoParserFlags	flags,
		const char **	parsed_until,
		struct ExpandoParseError *	err
	)

Parse a Date Expando - Implements ExpandoDefinition::parse() -.

Parse a custom Expando of the form, "%(string)". The "string" will be passed to strftime().

Definition at line 164 of file mutt_config.c.

{
  if (flags & EP_CONDITIONAL)
  {
    return node_conddate_parse(str, did, uid, parsed_until, err);
  }
 
  return node_expando_parse_enclosure(str, did, uid, ')', fmt, parsed_until, err);
}

Here is the call graph for this function:

parse_index_date_local()

struct ExpandoNode * parse_index_date_local	(	const char *	str,
		struct ExpandoFormat *	fmt,
		int	did,
		int	uid,
		ExpandoParserFlags	flags,
		const char **	parsed_until,
		struct ExpandoParseError *	err
	)

Parse a Date Expando - Implements ExpandoDefinition::parse() -.

Parse a custom expando of the form, "%[string]". The "string" will be passed to strftime().

Definition at line 184 of file mutt_config.c.

{
  if (flags & EP_CONDITIONAL)
  {
    return node_conddate_parse(str, did, uid, parsed_until, err);
  }
 
  return node_expando_parse_enclosure(str, did, uid, ']', fmt, parsed_until, err);
}

Here is the call graph for this function:

parse_index_date()

struct ExpandoNode * parse_index_date	(	const char *	str,
		struct ExpandoFormat *	fmt,
		int	did,
		int	uid,
		ExpandoParserFlags	flags,
		const char **	parsed_until,
		struct ExpandoParseError *	err
	)

Parse a Date Expando - Implements ExpandoDefinition::parse() -.

Parse a custom Expando of the form, "%{string}". The "string" will be passed to strftime().

Definition at line 203 of file mutt_config.c.

{
  if (flags & EP_CONDITIONAL)
  {
    return node_conddate_parse(str, did, uid, parsed_until, err);
  }
 
  return node_expando_parse_enclosure(str, did, uid, '}', fmt, parsed_until, err);
}

Here is the call graph for this function:

parse_index_hook()

struct ExpandoNode * parse_index_hook	(	const char *	str,
		struct ExpandoFormat *	fmt,
		int	did,
		int	uid,
		ExpandoParserFlags	flags,
		const char **	parsed_until,
		struct ExpandoParseError *	err
	)

Parse an index-hook - Implements ExpandoDefinition::parse() -.

Parse a custom Expando of the form, "%@name@". The "name" will be looked up as an index-hook, then the result parsed as an Expando.

Definition at line 223 of file mutt_config.c.

{
  if (flags & EP_CONDITIONAL)
  {
    snprintf(err->message, sizeof(err->message),
             _("index-hook cannot be used as a condition"));
    err->position = str;
    return NULL;
  }
 
  return node_expando_parse_enclosure(str, did, uid, '@', fmt, parsed_until, err);
}

Here is the call graph for this function:

parse_tags_transformed()

struct ExpandoNode * parse_tags_transformed	(	const char *	str,
		struct ExpandoFormat *	fmt,
		int	did,
		int	uid,
		ExpandoParserFlags	flags,
		const char **	parsed_until,
		struct ExpandoParseError *	err
	)

Parse a Tags-Transformed Expando - Implements ExpandoDefinition::parse() -.

Parse a custom expando of the form, "%G?" where '?' is an alpha-numeric character.

Definition at line 244 of file mutt_config.c.

{
  // Tag expando %G must use an suffix from [A-Za-z0-9], e.g. %Ga, %GL
  if (!isalnum(str[1]))
    return NULL;
 
  // Let the basic expando parser do the work
  flags |= EP_NO_CUSTOM_PARSE;
  struct ExpandoNode *node = parse_short_name(str, IndexFormatDef, flags, fmt,
                                              parsed_until, err);
 
  // but adjust the node to take one more character
  node->text = mutt_strn_dup((*parsed_until) - 1, 2);
  (*parsed_until)++;
 
  if (flags & EP_CONDITIONAL)
  {
    node->type = ENT_CONDBOOL;
    node->render = node_condbool_render;
  }
 
  return node;
}

Here is the call graph for this function:

parse_subject()

struct ExpandoNode * parse_subject	(	const char *	str,
		struct ExpandoFormat *	fmt,
		int	did,
		int	uid,
		ExpandoParserFlags	flags,
		const char **	parsed_until,
		struct ExpandoParseError *	err
	)

Parse a Subject Expando - Implements ExpandoDefinition::parse() -.

Parse a Subject Expando, "%s", into two separate Nodes. One for the tree, one for the subject.

Definition at line 277 of file mutt_config.c.

{
  // Let the basic expando parser do the work
  flags |= EP_NO_CUSTOM_PARSE;
  struct ExpandoNode *node_subj = parse_short_name(str, IndexFormatDef, flags,
                                                   NULL, parsed_until, err);
 
  struct ExpandoNode *node_tree = node_expando_new(NULL, ED_ENVELOPE, ED_ENV_THREAD_TREE);
  struct ExpandoNode *node_cont = node_container_new();
 
  // Apply the formatting info to the container
  node_cont->format = fmt;
 
  node_add_child(node_cont, node_tree);
  node_add_child(node_cont, node_subj);
 
  return node_cont;
}

Here is the call graph for this function:

parse_pgp_date()

struct ExpandoNode * parse_pgp_date	(	const char *	str,
		struct ExpandoFormat *	fmt,
		int	did,
		int	uid,
		ExpandoParserFlags	flags,
		const char **	parsed_until,
		struct ExpandoParseError *	err
	)

Parse a Date Expando - Implements ExpandoDefinition::parse() -.

Parse a custom Expando of the form, "%[string]". The "string" will be passed to strftime().

Definition at line 62 of file config.c.

{
  if (flags & EP_CONDITIONAL)
  {
    return node_conddate_parse(str, did, uid, parsed_until, err);
  }
 
  return node_expando_parse_enclosure(str, did, uid, ']', fmt, parsed_until, err);
}

Here is the call graph for this function: