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 64 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;
  switch (uid)
  {
    case ED_GLO_PADDING_EOL:
      pt = EPT_FILL_EOL;
      break;
 
    case ED_GLO_PADDING_HARD:
      pt = EPT_HARD_FILL;
      break;
 
    case ED_GLO_PADDING_SOFT:
      pt = EPT_SOFT_FILL;
      break;
 
    default:
      return NULL;
  }
 
  // Skip over the name
  str = *parsed_until + 1;
 
  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 162 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 182 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 201 of file mutt_config.c.

{
  if (flags & EP_CONDITIONAL)
  {
    return node_conddate_parse(str, did, uid, parsed_until, err);
  }
 
  struct ExpandoNode *node = node_expando_parse_enclosure(str, did, uid, '}',
                                                          fmt, parsed_until, err);
  if (!node)
    return NULL;
 
  const char *pc = strchr(NONULL(node->text), '%');
  if (!pc)
  {
    snprintf(err->message, sizeof(err->message), _("Unknown expando: %%{%s}"), node->text);
    err->position = str;
    node_free(&node);
  }
 
  return node;
}

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 234 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 alphanumeric character.

Definition at line 255 of file mutt_config.c.

{
  // Tag expando %G must use a suffix from [A-Za-z0-9], e.g. %Ga, %GL
  if (!mutt_isalnum(str[1]))
    return NULL;
 
  struct ExpandoNode *node = node_expando_new(fmt, did, uid);
 
  node->text = mutt_strn_dup(str, 2);
 
  if (flags & EP_CONDITIONAL)
  {
    node->type = ENT_CONDBOOL;
    node->render = node_condbool_render;
  }
 
  (*parsed_until) = str + 2;
 
  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 285 of file mutt_config.c.

{
  struct ExpandoNode *node_subj = node_expando_new(NULL, did, uid);
  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);
 
  if (*parsed_until[0] != '}')
    (*parsed_until)++;
 
  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 63 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: