Expando Render API

Render an Expando. More...

Functions
int	node_condbool_render (const struct ExpandoNode *node, const struct ExpandoRenderData *rdata, struct Buffer *buf, int max_cols, void *data, MuttFormatFlags flags)
	Callback for every bool node - Implements ExpandoNode::render() -.
int	node_conddate_render (const struct ExpandoNode *node, const struct ExpandoRenderData *rdata, struct Buffer *buf, int max_cols, void *data, MuttFormatFlags flags)
	Render a CondDate Node - Implements ExpandoNode::render() -.
static int	node_condition_render (const struct ExpandoNode *node, const struct ExpandoRenderData *rdata, struct Buffer *buf, int max_cols, void *data, MuttFormatFlags flags)
	Render a Conditional Node - Implements ExpandoNode::render() -.
int	node_container_render (const struct ExpandoNode *node, const struct ExpandoRenderData *rdata, struct Buffer *buf, int max_cols, void *data, MuttFormatFlags flags)
	Callback for a Container Node - Implements ExpandoNode::render() -.
int	node_expando_render (const struct ExpandoNode *node, const struct ExpandoRenderData *rdata, struct Buffer *buf, int max_cols, void *data, MuttFormatFlags flags)
	Render an Expando Node - Implements ExpandoNode::render() -.
int	node_padding_render_eol (const struct ExpandoNode *node, const struct ExpandoRenderData *rdata, struct Buffer *buf, int max_cols, void *data, MuttFormatFlags flags)
	Render End-of-Line Padding - Implements ExpandoNode::render() -.
int	node_padding_render_hard (const struct ExpandoNode *node, const struct ExpandoRenderData *rdata, struct Buffer *buf, int max_cols, void *data, MuttFormatFlags flags)
	Render Hard Padding - Implements ExpandoNode::render() -.
int	node_padding_render_soft (const struct ExpandoNode *node, const struct ExpandoRenderData *rdata, struct Buffer *buf, int max_cols, void *data, MuttFormatFlags flags)
	Render Soft Padding - Implements ExpandoNode::render() -.
static int	node_text_render (const struct ExpandoNode *node, const struct ExpandoRenderData *rdata, struct Buffer *buf, int max_cols, void *data, MuttFormatFlags flags)
	Render a Text Node - Implements ExpandoNode::render() -.

Detailed Description

Render an Expando.

Parameters

[in]	node	Node to render
[out]	buf	Buffer in which to save string
[in]	max_cols	Maximum number of screen columns to use
[in]	data	Private data
[in]	flags	Flags, see MuttFormatFlags

Return values

num	Number of screen columns used

Function Documentation

node_condbool_render()

int node_condbool_render	(	const struct ExpandoNode *	node,
		const struct ExpandoRenderData *	rdata,
		struct Buffer *	buf,
		int	max_cols,
		void *	data,
		MuttFormatFlags	flags
	)

Callback for every bool node - Implements ExpandoNode::render() -.

Definition at line 111 of file node_condbool.c.

{
  assert(node->type == ENT_CONDBOOL);
 
  const struct ExpandoRenderData *rd_match = find_get_number(rdata, node->did, node->uid);
  if (rd_match)
  {
    const long num = rd_match->get_number(node, data, flags);
    return (num != 0); // bool-ify
  }
 
  rd_match = find_get_string(rdata, node->did, node->uid);
  if (rd_match)
  {
    struct Buffer *buf_str = buf_pool_get();
    rd_match->get_string(node, data, flags, max_cols, buf_str);
    const size_t len = buf_len(buf_str);
    buf_pool_release(&buf_str);
 
    return (len > 0); // bool-ify
  }
 
  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

node_conddate_render()

int node_conddate_render	(	const struct ExpandoNode *	node,
		const struct ExpandoRenderData *	rdata,
		struct Buffer *	buf,
		int	max_cols,
		void *	data,
		MuttFormatFlags	flags
	)

Render a CondDate Node - Implements ExpandoNode::render() -.

Definition at line 75 of file node_conddate.c.

{
  assert(node->type == ENT_CONDDATE);
 
  const struct ExpandoRenderData *rd_match = find_get_number(rdata, node->did, node->uid);
  assert(rd_match && "Unknown UID");
 
  const long t_test = rd_match->get_number(node, data, flags);
 
  const struct NodeCondDatePrivate *priv = node->ndata;
 
  time_t t = mutt_date_now();
  struct tm tm = { 0 };
  gmtime_r(&t, &tm);
 
  switch (priv->period)
  {
    case 'y':
      tm.tm_year -= priv->count;
      break;
 
    case 'm':
      tm.tm_mon -= priv->count;
      break;
 
    case 'w':
      tm.tm_mday -= (7 * priv->count);
      break;
 
    case 'd':
      tm.tm_mday -= priv->count;
      break;
 
    case 'H':
      tm.tm_hour -= priv->count;
      break;
 
    case 'M':
      tm.tm_min -= priv->count;
      break;
  }
 
  const time_t t_cutoff = mktime(&tm);
 
  return (t_test > t_cutoff); // bool-ify
}

Here is the call graph for this function:

Here is the caller graph for this function:

node_condition_render()

static int node_condition_render ( const struct ExpandoNode *  node, const struct ExpandoRenderData *  rdata, struct Buffer *  buf, int  max_cols, void *  data, MuttFormatFlags  flags  )

static

Render a Conditional Node - Implements ExpandoNode::render() -.

Definition at line 41 of file node_condition.c.

{
  assert(node->type == ENT_CONDITION);
 
  const struct ExpandoNode *node_cond = node_get_child(node, ENC_CONDITION);
 
  // Discard any text returned, just use the return value as a bool
  struct Buffer *buf_cond = buf_pool_get();
  int rc = node_cond->render(node_cond, rdata, buf_cond, max_cols, data, flags);
  buf_pool_release(&buf_cond);
 
  if (rc == true)
  {
    const struct ExpandoNode *node_true = node_get_child(node, ENC_TRUE);
    return node_tree_render(node_true, rdata, buf, max_cols, data, flags);
  }
  else
  {
    const struct ExpandoNode *node_false = node_get_child(node, ENC_FALSE);
    return node_tree_render(node_false, rdata, buf, max_cols, data, flags);
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

node_container_render()

int node_container_render	(	const struct ExpandoNode *	node,
		const struct ExpandoRenderData *	rdata,
		struct Buffer *	buf,
		int	max_cols,
		void *	data,
		MuttFormatFlags	flags
	)

Callback for a Container Node - Implements ExpandoNode::render() -.

Definition at line 44 of file node_container.c.

{
  assert(node->type == ENT_CONTAINER);
 
  const struct ExpandoFormat *fmt = node->format;
  if (fmt)
    max_cols = MIN(max_cols, fmt->max_cols);
 
  int total_cols = 0;
 
  struct Buffer *tmp = buf_pool_get();
  struct ExpandoNode **enp = NULL;
  ARRAY_FOREACH(enp, &node->children)
  {
    total_cols += node_tree_render(*enp, rdata, tmp, max_cols - total_cols, data, flags);
  }
 
  if (fmt)
  {
    int min_cols = MIN(fmt->min_cols, max_cols);
    struct Buffer *tmp2 = buf_pool_get();
    total_cols = format_string(tmp2, min_cols, max_cols, fmt->justification,
                               fmt->leader, buf_string(tmp), buf_len(tmp), true);
    if (fmt->lower)
      buf_lower_special(tmp2);
    buf_addstr(buf, buf_string(tmp2));
    buf_pool_release(&tmp2);
  }
  else
  {
    buf_addstr(buf, buf_string(tmp));
  }
 
  buf_pool_release(&tmp);
  return total_cols;
}

Here is the call graph for this function:

Here is the caller graph for this function:

node_expando_render()

int node_expando_render	(	const struct ExpandoNode *	node,
		const struct ExpandoRenderData *	rdata,
		struct Buffer *	buf,
		int	max_cols,
		void *	data,
		MuttFormatFlags	flags
	)

Render an Expando Node - Implements ExpandoNode::render() -.

Definition at line 345 of file node_expando.c.

{
  assert(node->type == ENT_EXPANDO);
 
  struct Buffer *buf_expando = buf_pool_get();
 
  const struct ExpandoRenderData *rd_match = find_get_string(rdata, node->did, node->uid);
  if (rd_match)
  {
    rd_match->get_string(node, data, flags, max_cols, buf_expando);
  }
  else
  {
    rd_match = find_get_number(rdata, node->did, node->uid);
    assert(rd_match && "Unknown UID");
 
    const long num = rd_match->get_number(node, data, flags);
    buf_printf(buf_expando, "%ld", num);
  }
 
  int total_cols = 0;
 
  const struct NodeExpandoPrivate *priv = node->ndata;
 
  if (priv->color > -1)
    add_color(buf, priv->color);
 
  struct Buffer *tmp = buf_pool_get();
  const struct ExpandoFormat *fmt = node->format;
  if (fmt)
  {
    max_cols = MIN(max_cols, fmt->max_cols);
    int min_cols = MIN(max_cols, fmt->min_cols);
    total_cols += format_string(tmp, min_cols, max_cols, fmt->justification,
                                fmt->leader, buf_string(buf_expando),
                                buf_len(buf_expando), priv->has_tree);
    if (fmt->lower)
      buf_lower_special(tmp);
  }
  else
  {
    total_cols += format_string(tmp, 0, max_cols, JUSTIFY_LEFT, 0, buf_string(buf_expando),
                                buf_len(buf_expando), priv->has_tree);
  }
  buf_addstr(buf, buf_string(tmp));
  buf_pool_release(&tmp);
 
  if (priv->color > -1)
    add_color(buf, MT_COLOR_INDEX);
 
  buf_pool_release(&buf_expando);
  return total_cols;
}

Here is the call graph for this function:

Here is the caller graph for this function:

node_padding_render_eol()

int node_padding_render_eol	(	const struct ExpandoNode *	node,
		const struct ExpandoRenderData *	rdata,
		struct Buffer *	buf,
		int	max_cols,
		void *	data,
		MuttFormatFlags	flags
	)

Render End-of-Line Padding - Implements ExpandoNode::render() -.

Definition at line 102 of file node_padding.c.

{
  struct ExpandoNode *left = node_get_child(node, ENP_LEFT);
 
  int total_cols = node_tree_render(left, rdata, buf, max_cols, data, flags);
 
  total_cols += pad_string(node, buf, max_cols - total_cols);
 
  return total_cols;
}

Here is the call graph for this function:

Here is the caller graph for this function:

node_padding_render_hard()

int node_padding_render_hard	(	const struct ExpandoNode *	node,
		const struct ExpandoRenderData *	rdata,
		struct Buffer *	buf,
		int	max_cols,
		void *	data,
		MuttFormatFlags	flags
	)

Render Hard Padding - Implements ExpandoNode::render() -.

Text to the left of the padding is hard and will be preserved if possible. Text to the right of the padding will be truncated.

Definition at line 121 of file node_padding.c.

{
  struct Buffer *buf_left = buf_pool_get();
  struct Buffer *buf_pad = buf_pool_get();
  struct Buffer *buf_right = buf_pool_get();
 
  int cols_used = 0;
 
  struct ExpandoNode *left = node_get_child(node, ENP_LEFT);
  if (left)
    cols_used += node_tree_render(left, rdata, buf_left, max_cols - cols_used, data, flags);
 
  struct ExpandoNode *right = node_get_child(node, ENP_RIGHT);
  if (right)
    cols_used += node_tree_render(right, rdata, buf_right, max_cols - cols_used, data, flags);
 
  if (max_cols > cols_used)
    cols_used += pad_string(node, buf_pad, max_cols - cols_used);
 
  buf_addstr(buf, buf_string(buf_left));
  buf_addstr(buf, buf_string(buf_pad));
  buf_addstr(buf, buf_string(buf_right));
 
  buf_pool_release(&buf_left);
  buf_pool_release(&buf_pad);
  buf_pool_release(&buf_right);
 
  return cols_used;
}

Here is the call graph for this function:

Here is the caller graph for this function:

node_padding_render_soft()

int node_padding_render_soft	(	const struct ExpandoNode *	node,
		const struct ExpandoRenderData *	rdata,
		struct Buffer *	buf,
		int	max_cols,
		void *	data,
		MuttFormatFlags	flags
	)

Render Soft Padding - Implements ExpandoNode::render() -.

Text to the right of the padding is hard and will be preserved if possible. Text to the left of the padding will be truncated.

Definition at line 159 of file node_padding.c.

{
  struct Buffer *buf_left = buf_pool_get();
  struct Buffer *buf_pad = buf_pool_get();
  struct Buffer *buf_right = buf_pool_get();
 
  int cols_used = 0;
 
  struct ExpandoNode *right = node_get_child(node, ENP_RIGHT);
  if (right)
    cols_used += node_tree_render(right, rdata, buf_right, max_cols - cols_used, data, flags);
 
  struct ExpandoNode *left = node_get_child(node, ENP_LEFT);
  if (left)
    cols_used += node_tree_render(left, rdata, buf_left, max_cols - cols_used, data, flags);
 
  if (max_cols > cols_used)
    cols_used += pad_string(node, buf_pad, max_cols - cols_used);
 
  buf_addstr(buf, buf_string(buf_left));
  buf_addstr(buf, buf_string(buf_pad));
  buf_addstr(buf, buf_string(buf_right));
 
  buf_pool_release(&buf_left);
  buf_pool_release(&buf_pad);
  buf_pool_release(&buf_right);
 
  return cols_used;
}

Here is the call graph for this function:

Here is the caller graph for this function:

node_text_render()

static int node_text_render ( const struct ExpandoNode *  node, const struct ExpandoRenderData *  rdata, struct Buffer *  buf, int  max_cols, void *  data, MuttFormatFlags  flags  )

static

Render a Text Node - Implements ExpandoNode::render() -.

Definition at line 43 of file node_text.c.

{
  assert(node->type == ENT_TEXT);
 
  const int num_bytes = node->end - node->start;
  return format_string(buf, 0, max_cols, JUSTIFY_LEFT, ' ', node->start, num_bytes, false);
}

Here is the call graph for this function:

Here is the caller graph for this function: