set.c File Reference

A collection of config items. More...

#include "config.h"
#include <limits.h>
#include <stdio.h>
#include "mutt/lib.h"
#include "set.h"
#include "inheritance.h"
#include "types.h"

Include dependency graph for set.c:

Go to the source code of this file.

Functions
static void	cs_hashelem_free (int type, void *obj, intptr_t data)
	Callback function for the Hash Table - Implements hash_hdata_free_t -. More...
static struct HashElem *	create_synonym (const struct ConfigSet *cs, struct ConfigDef *cdef, struct Buffer *err)
	Create an alternative name for a config item. More...
struct ConfigSet *	cs_new (size_t size)
	Create a new Config Set. More...
void	cs_free (struct ConfigSet **ptr)
	Free a Config Set. More...
struct HashElem *	cs_get_base (struct HashElem *he)
	Find the root Config Item. More...
struct HashElem *	cs_get_elem (const struct ConfigSet *cs, const char *name)
	Get the HashElem representing a config item. More...
const struct ConfigSetType *	cs_get_type_def (const struct ConfigSet *cs, unsigned int type)
	Get the definition for a type. More...
bool	cs_register_type (struct ConfigSet *cs, const struct ConfigSetType *cst)
	Register a type of config item. More...
struct HashElem *	cs_register_variable (const struct ConfigSet *cs, struct ConfigDef *cdef, struct Buffer *err)
	Register one config item. More...
bool	cs_register_variables (const struct ConfigSet *cs, struct ConfigDef vars[], uint32_t flags)
	Register a set of config items. More...
struct HashElem *	cs_create_variable (const struct ConfigSet *cs, struct ConfigDef *cdef, struct Buffer *err)
	Create and register one config item. More...
struct HashElem *	cs_inherit_variable (const struct ConfigSet *cs, struct HashElem *he_parent, const char *name)
	Create in inherited config item. More...
void	cs_uninherit_variable (const struct ConfigSet *cs, const char *name)
	Remove an inherited config item. More...
int	cs_he_reset (const struct ConfigSet *cs, struct HashElem *he, struct Buffer *err)
	Reset a config item to its initial value. More...
int	cs_str_reset (const struct ConfigSet *cs, const char *name, struct Buffer *err)
	Reset a config item to its initial value. More...
int	cs_he_initial_set (const struct ConfigSet *cs, struct HashElem *he, const char *value, struct Buffer *err)
	Set the initial value of a config item. More...
int	cs_str_initial_set (const struct ConfigSet *cs, const char *name, const char *value, struct Buffer *err)
	Set the initial value of a config item. More...
int	cs_he_initial_get (const struct ConfigSet *cs, struct HashElem *he, struct Buffer *result)
	Get the initial, or parent, value of a config item. More...
int	cs_str_initial_get (const struct ConfigSet *cs, const char *name, struct Buffer *result)
	Get the initial, or parent, value of a config item. More...
int	cs_he_string_set (const struct ConfigSet *cs, struct HashElem *he, const char *value, struct Buffer *err)
	Set a config item by string. More...
int	cs_str_string_set (const struct ConfigSet *cs, const char *name, const char *value, struct Buffer *err)
	Set a config item by string. More...
int	cs_he_string_get (const struct ConfigSet *cs, struct HashElem *he, struct Buffer *result)
	Get a config item as a string. More...
int	cs_str_string_get (const struct ConfigSet *cs, const char *name, struct Buffer *result)
	Get a config item as a string. More...
int	cs_he_native_set (const struct ConfigSet *cs, struct HashElem *he, intptr_t value, struct Buffer *err)
	Natively set the value of a HashElem config item. More...
int	cs_str_native_set (const struct ConfigSet *cs, const char *name, intptr_t value, struct Buffer *err)
	Natively set the value of a string config item. More...
intptr_t	cs_he_native_get (const struct ConfigSet *cs, struct HashElem *he, struct Buffer *err)
	Natively get the value of a HashElem config item. More...
intptr_t	cs_str_native_get (const struct ConfigSet *cs, const char *name, struct Buffer *err)
	Natively get the value of a string config item. More...
int	cs_he_string_plus_equals (const struct ConfigSet *cs, struct HashElem *he, const char *value, struct Buffer *err)
	Add to a config item by string. More...
int	cs_str_string_plus_equals (const struct ConfigSet *cs, const char *name, const char *value, struct Buffer *err)
	Add to a config item by string. More...
int	cs_he_string_minus_equals (const struct ConfigSet *cs, struct HashElem *he, const char *value, struct Buffer *err)
	Remove from a config item by string. More...
int	cs_str_string_minus_equals (const struct ConfigSet *cs, const char *name, const char *value, struct Buffer *err)
	Remove from a config item by string. More...
int	cs_he_delete (const struct ConfigSet *cs, struct HashElem *he, struct Buffer *err)
	Delete config item from a config set. More...
int	cs_str_delete (const struct ConfigSet *cs, const char *name, struct Buffer *err)
	Delete config item from a config set. More...

Detailed Description

A collection of config items.

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 set.c.

Function Documentation

create_synonym()

static struct HashElem * create_synonym ( const struct ConfigSet *  cs, struct ConfigDef *  cdef, struct Buffer *  err  )

static

Create an alternative name for a config item.

Parameters

cs	Config items
cdef	Variable definition
err	Buffer for error messages

Return values

ptr	New HashElem representing the config item synonym

Definition at line 96 of file set.c.

{
  if (!cs || !cdef)
    return NULL; /* LCOV_EXCL_LINE */
 
  const char *name = (const char *) cdef->initial;
  struct HashElem *he_parent = cs_get_elem(cs, name);
  if (!he_parent)
  {
    buf_printf(err, _("No such variable: %s"), name);
    return NULL;
  }
 
  struct HashElem *he_child = mutt_hash_typed_insert(cs->hash, cdef->name,
                                                     cdef->type, (void *) cdef);
  if (!he_child)
    return NULL; /* LCOV_EXCL_LINE */
 
  cdef->var = (intptr_t) he_parent;
  return he_child;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_new()

struct ConfigSet * cs_new

(

size_t

size

)

Create a new Config Set.

Parameters

size	Number of expected config items

Return values

ptr	New ConfigSet object

Definition at line 124 of file set.c.

{
  struct ConfigSet *cs = mutt_mem_calloc(1, sizeof(*cs));
 
  cs->hash = mutt_hash_new(size, MUTT_HASH_NO_FLAGS);
  mutt_hash_set_destructor(cs->hash, cs_hashelem_free, (intptr_t) cs);
 
  return cs;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_free()

void cs_free

(

struct ConfigSet **

ptr

)

Free a Config Set.

Parameters

[out]

ptr

Config items

Definition at line 138 of file set.c.

{
  if (!ptr || !*ptr)
    return;
 
  struct ConfigSet *cs = *ptr;
 
  mutt_hash_free(&cs->hash);
  FREE(ptr);
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_get_base()

struct HashElem * cs_get_base

(

struct HashElem *

he

)

Find the root Config Item.

Parameters

he	Config Item to examine

Return values

ptr	Root Config Item

Given an inherited HashElem, find the HashElem representing the original Config Item.

Definition at line 157 of file set.c.

{
  if (!(he->type & DT_INHERITED))
    return he;
 
  struct Inheritance *i = he->data;
  return cs_get_base(i->parent);
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_get_elem()

struct HashElem * cs_get_elem	(	const struct ConfigSet *	cs,
		const char *	name
	)

Get the HashElem representing a config item.

Parameters

cs	Config items
name	Name of config item

Return values

ptr	HashElem representing the config item

Definition at line 172 of file set.c.

{
  if (!cs || !name)
    return NULL;
 
  struct HashElem *he = mutt_hash_find_elem(cs->hash, name);
  if (!he)
    return NULL;
 
  if (DTYPE(he->type) != DT_SYNONYM)
    return he;
 
  const struct ConfigDef *cdef = he->data;
 
  return (struct HashElem *) cdef->var;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_get_type_def()

const struct ConfigSetType * cs_get_type_def	(	const struct ConfigSet *	cs,
		unsigned int	type
	)

Get the definition for a type.

Parameters

cs	Config items
type	Type to lookup, e.g. DT_NUMBER

Return values

ptr	ConfigSetType representing the type

Definition at line 195 of file set.c.

{
  if (!cs)
    return NULL;
 
  type = DTYPE(type);
  if (type >= mutt_array_size(cs->types))
    return NULL;
 
  if (!cs->types[type].name)
    return NULL;
 
  return &cs->types[type];
}

Here is the caller graph for this function:

cs_register_type()

bool cs_register_type	(	struct ConfigSet *	cs,
		const struct ConfigSetType *	cst
	)

Register a type of config item.

Parameters

cs	Config items
cst	Structure defining the type

Return values

true	Type was registered successfully

Definition at line 216 of file set.c.

{
  if (!cs || !cst)
    return false;
 
  if (!cst->name || !cst->string_set || !cst->string_get || !cst->reset ||
      !cst->native_set || !cst->native_get)
  {
    return false;
  }
 
  if (cst->type >= mutt_array_size(cs->types))
    return false;
 
  if (cs->types[cst->type].name)
    return false; /* already registered */
 
  cs->types[cst->type] = *cst;
  return true;
}

cs_register_variable()

struct HashElem * cs_register_variable	(	const struct ConfigSet *	cs,
		struct ConfigDef *	cdef,
		struct Buffer *	err
	)

Register one config item.

Parameters

cs	Config items
cdef	Variable definition
err	Buffer for error messages

Return values

ptr	New HashElem representing the config item

Similar to cs_create_variable() but assumes that cdef lives indefinitely.

Definition at line 246 of file set.c.

{
  if (!cs || !cdef)
    return NULL; /* LCOV_EXCL_LINE */
 
  if (DTYPE(cdef->type) == DT_SYNONYM)
    return create_synonym(cs, cdef, err);
 
  const struct ConfigSetType *cst = cs_get_type_def(cs, cdef->type);
  if (!cst)
  {
    buf_printf(err, _("Variable '%s' has an invalid type %d"), cdef->name, cdef->type);
    return NULL;
  }
 
  struct HashElem *he = mutt_hash_typed_insert(cs->hash, cdef->name, cdef->type, cdef);
  if (!he)
    return NULL; /* LCOV_EXCL_LINE */
 
  if (cst->reset)
    cst->reset(cs, &cdef->var, cdef, err);
 
  return he;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_register_variables()

bool cs_register_variables	(	const struct ConfigSet *	cs,
		struct ConfigDef	vars[],
		uint32_t	flags
	)

Register a set of config items.

Parameters

cs	Config items
vars	Variable definition
flags	Flags, e.g. DT_DEPRECATED

Return values

true	All variables were registered successfully

Definition at line 279 of file set.c.

{
  if (!cs || !vars)
    return false;
 
  struct Buffer err = buf_make(0);
 
  bool rc = true;
 
  for (size_t i = 0; vars[i].name; i++)
  {
    vars[i].type |= flags;
    if (!cs_register_variable(cs, &vars[i], &err))
    {
      mutt_debug(LL_DEBUG1, "%s\n", buf_string(&err));
      rc = false;
    }
  }
 
  buf_dealloc(&err);
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_create_variable()

struct HashElem * cs_create_variable	(	const struct ConfigSet *	cs,
		struct ConfigDef *	cdef,
		struct Buffer *	err
	)

Create and register one config item.

Parameters

cs	Config items
cdef	Variable definition
err	Buffer for error messages

Return values

ptr	New HashElem representing the config item

Similar to cs_register_variable() but copies the ConfigDef first. Allowing the caller to free it and its parts afterwards.

This function does not know anything about how the internal representation of the type must be handled. Thus, the fields 'initial', 'data', 'var' must be copyable. If they need allocation, then the caller must set them after the variable is created, e.g. with cs_he_initial_set(), cs_he_native_set.

Definition at line 317 of file set.c.

{
  struct ConfigDef *cdef_copy = mutt_mem_calloc(1, sizeof(struct ConfigDef));
  cdef_copy->name = mutt_str_dup(cdef->name);
  cdef_copy->type = cdef->type | DT_FREE_CONFIGDEF;
  cdef_copy->initial = cdef->initial;
  cdef_copy->data = cdef->data;
  cdef_copy->validator = cdef->validator;
  cdef_copy->docs = mutt_str_dup(cdef->name);
  cdef_copy->var = cdef->var;
 
  struct HashElem *he = cs_register_variable(cs, cdef_copy, err);
  if (!he)
  {
    FREE(&cdef_copy->name);
    FREE(&cdef_copy->docs);
    FREE(&cdef_copy);
  }
  return he;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_inherit_variable()

struct HashElem * cs_inherit_variable	(	const struct ConfigSet *	cs,
		struct HashElem *	he_parent,
		const char *	name
	)

Create in inherited config item.

Parameters

cs	Config items
he_parent	HashElem of parent config item
name	Name of account-specific config item

Return values

ptr	New HashElem representing the inherited config item

Definition at line 346 of file set.c.

{
  if (!cs || !he_parent)
    return NULL;
 
  /* MyVars cannot be inherited, as they might get deleted */
  if (DTYPE(he_parent->type) == DT_MYVAR)
    return NULL;
 
  struct Inheritance *i = mutt_mem_calloc(1, sizeof(*i));
  i->parent = he_parent;
  i->name = mutt_str_dup(name);
 
  struct HashElem *he = mutt_hash_typed_insert(cs->hash, i->name, DT_INHERITED, i);
  if (!he)
  {
    FREE(&i->name);
    FREE(&i);
  }
 
  return he;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_uninherit_variable()

void cs_uninherit_variable	(	const struct ConfigSet *	cs,
		const char *	name
	)

Remove an inherited config item.

Parameters

cs	Config items
name	Name of config item to remove

Definition at line 375 of file set.c.

{
  if (!cs || !name)
    return;
 
  mutt_hash_delete(cs->hash, name, NULL);
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_he_reset()

int cs_he_reset	(	const struct ConfigSet *	cs,
		struct HashElem *	he,
		struct Buffer *	err
	)

Reset a config item to its initial value.

Parameters

cs	Config items
he	HashElem representing config item
err	Buffer for error messages

Return values

num	Result, e.g. CSR_SUCCESS

Definition at line 390 of file set.c.

{
  if (!cs || !he)
    return CSR_ERR_CODE;
 
  /* An inherited var that's already pointing to its parent.
   * Return 'success', but don't send a notification. */
  if ((he->type & DT_INHERITED) && (DTYPE(he->type) == 0))
    return CSR_SUCCESS;
 
  int rc = CSR_SUCCESS;
 
  if (he->type & DT_INHERITED)
  {
    struct Inheritance *i = he->data;
    struct HashElem *he_base = cs_get_base(he);
    struct ConfigDef *cdef = he_base->data;
    if (!cdef)
      return CSR_ERR_CODE; // LCOV_EXCL_LINE
 
    const struct ConfigSetType *cst = cs_get_type_def(cs, he_base->type);
    if (cst && cst->destroy)
      cst->destroy(cs, (void **) &i->var, cdef);
 
    he->type = DT_INHERITED;
  }
  else
  {
    struct ConfigDef *cdef = he->data;
    if (!cdef)
      return CSR_ERR_CODE; // LCOV_EXCL_LINE
 
    const struct ConfigSetType *cst = cs_get_type_def(cs, he->type);
    if (cst)
      rc = cst->reset(cs, &cdef->var, cdef, err);
  }
 
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_str_reset()

int cs_str_reset	(	const struct ConfigSet *	cs,
		const char *	name,
		struct Buffer *	err
	)

Reset a config item to its initial value.

Parameters

cs	Config items
name	Name of config item
err	Buffer for error messages

Return values

num	Result, e.g. CSR_SUCCESS

Definition at line 437 of file set.c.

{
  if (!cs || !name)
    return CSR_ERR_CODE;
 
  struct HashElem *he = cs_get_elem(cs, name);
  if (!he)
  {
    buf_printf(err, _("Unknown variable '%s'"), name);
    return CSR_ERR_UNKNOWN;
  }
 
  return cs_he_reset(cs, he, err);
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_he_initial_set()

int cs_he_initial_set	(	const struct ConfigSet *	cs,
		struct HashElem *	he,
		const char *	value,
		struct Buffer *	err
	)

Set the initial value of a config item.

Parameters

cs	Config items
he	HashElem representing config item
value	Value to set
err	Buffer for error messages

Return values

num	Result, e.g. CSR_SUCCESS

Definition at line 460 of file set.c.

{
  if (!cs || !he)
    return CSR_ERR_CODE;
 
  struct ConfigDef *cdef = NULL;
 
  if (he->type & DT_INHERITED)
  {
    struct HashElem *he_base = cs_get_base(he);
    cdef = he_base->data;
    mutt_debug(LL_DEBUG1, "Variable '%s' is inherited type\n", cdef->name);
    return CSR_ERR_CODE;
  }
 
  cdef = he->data;
  if (!cdef)
    return CSR_ERR_CODE; // LCOV_EXCL_LINE
 
  const struct ConfigSetType *cst = cs_get_type_def(cs, he->type);
  if (!cst)
  {
    mutt_debug(LL_DEBUG1, "Variable '%s' has an invalid type %d\n", cdef->name, he->type);
    return CSR_ERR_CODE;
  }
 
  int rc = cst->string_set(cs, NULL, cdef, value, err);
  if (CSR_RESULT(rc) != CSR_SUCCESS)
    return rc;
 
  return CSR_SUCCESS;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_str_initial_set()

int cs_str_initial_set	(	const struct ConfigSet *	cs,
		const char *	name,
		const char *	value,
		struct Buffer *	err
	)

Set the initial value of a config item.

Parameters

cs	Config items
name	Name of config item
value	Value to set
err	Buffer for error messages

Return values

num	Result, e.g. CSR_SUCCESS

Definition at line 502 of file set.c.

{
  if (!cs || !name)
    return CSR_ERR_CODE;
 
  struct HashElem *he = cs_get_elem(cs, name);
  if (!he)
  {
    buf_printf(err, _("Unknown variable '%s'"), name);
    return CSR_ERR_UNKNOWN;
  }
 
  return cs_he_initial_set(cs, he, value, err);
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_he_initial_get()

int cs_he_initial_get	(	const struct ConfigSet *	cs,
		struct HashElem *	he,
		struct Buffer *	result
	)

Get the initial, or parent, value of a config item.

Parameters

cs	Config items
he	HashElem representing config item
result	Buffer for results or error messages

Return values

num	Result, e.g. CSR_SUCCESS

If a config item is inherited from another, then this will get the parent's value. Otherwise, it will get the config item's initial value.

Definition at line 528 of file set.c.

{
  if (!cs || !he || !result)
    return CSR_ERR_CODE;
 
  const struct ConfigDef *cdef = NULL;
  const struct ConfigSetType *cst = NULL;
 
  if (he->type & DT_INHERITED)
  {
    struct HashElem *he_base = cs_get_base(he);
    cdef = he_base->data;
    cst = cs_get_type_def(cs, he_base->type);
  }
  else
  {
    cdef = he->data;
    cst = cs_get_type_def(cs, he->type);
  }
 
  if (!cst)
    return CSR_ERR_CODE; // LCOV_EXCL_LINE
 
  return cst->string_get(cs, NULL, cdef, result);
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_str_initial_get()

int cs_str_initial_get	(	const struct ConfigSet *	cs,
		const char *	name,
		struct Buffer *	result
	)

Get the initial, or parent, value of a config item.

Parameters

cs	Config items
name	Name of config item
result	Buffer for results or error messages

Return values

num	Result, e.g. CSR_SUCCESS

If a config item is inherited from another, then this will get the parent's value. Otherwise, it will get the config item's initial value.

Definition at line 564 of file set.c.

{
  if (!cs || !name)
    return CSR_ERR_CODE;
 
  struct HashElem *he = cs_get_elem(cs, name);
  if (!he)
  {
    buf_printf(result, _("Unknown variable '%s'"), name);
    return CSR_ERR_UNKNOWN;
  }
 
  return cs_he_initial_get(cs, he, result);
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_he_string_set()

int cs_he_string_set	(	const struct ConfigSet *	cs,
		struct HashElem *	he,
		const char *	value,
		struct Buffer *	err
	)

Set a config item by string.

Parameters

cs	Config items
he	HashElem representing config item
value	Value to set
err	Buffer for error messages

Return values

num	Result, e.g. CSR_SUCCESS

Definition at line 587 of file set.c.

{
  if (!cs || !he)
    return CSR_ERR_CODE;
 
  struct ConfigDef *cdef = NULL;
  const struct ConfigSetType *cst = NULL;
  void *var = NULL;
 
  if (he->type & DT_INHERITED)
  {
    struct Inheritance *i = he->data;
    struct HashElem *he_base = cs_get_base(he);
    cdef = he_base->data;
    cst = cs_get_type_def(cs, he_base->type);
    var = &i->var;
  }
  else
  {
    cdef = he->data;
    cst = cs_get_type_def(cs, he->type);
    var = &cdef->var;
  }
 
  if (!cdef)
    return CSR_ERR_CODE; // LCOV_EXCL_LINE
 
  if (!cst)
  {
    mutt_debug(LL_DEBUG1, "Variable '%s' has an invalid type %d\n", cdef->name, he->type);
    return CSR_ERR_CODE;
  }
 
  int rc = cst->string_set(cs, var, cdef, value, err);
  if (CSR_RESULT(rc) != CSR_SUCCESS)
    return rc;
 
  if (he->type & DT_INHERITED)
    he->type = cdef->type | DT_INHERITED;
 
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_str_string_set()

int cs_str_string_set	(	const struct ConfigSet *	cs,
		const char *	name,
		const char *	value,
		struct Buffer *	err
	)

Set a config item by string.

Parameters

cs	Config items
name	Name of config item
value	Value to set
err	Buffer for error messages

Return values

num	Result, e.g. CSR_SUCCESS

Definition at line 639 of file set.c.

{
  if (!cs || !name)
    return CSR_ERR_CODE;
 
  struct HashElem *he = cs_get_elem(cs, name);
  if (!he)
  {
    buf_printf(err, _("Unknown variable '%s'"), name);
    return CSR_ERR_UNKNOWN;
  }
 
  return cs_he_string_set(cs, he, value, err);
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_he_string_get()

int cs_he_string_get	(	const struct ConfigSet *	cs,
		struct HashElem *	he,
		struct Buffer *	result
	)

Get a config item as a string.

Parameters

cs	Config items
he	HashElem representing config item
result	Buffer for results or error messages

Return values

num	Result, e.g. CSR_SUCCESS

Definition at line 662 of file set.c.

{
  if (!cs || !he || !result)
    return CSR_ERR_CODE;
 
  struct ConfigDef *cdef = NULL;
  const struct ConfigSetType *cst = NULL;
  void *var = NULL;
 
  if (he->type & DT_INHERITED)
  {
    struct Inheritance *i = he->data;
 
    // inherited, value not set
    if (DTYPE(he->type) == 0)
      return cs_he_string_get(cs, i->parent, result);
 
    // inherited, value set
    struct HashElem *he_base = cs_get_base(he);
    cdef = he_base->data;
    cst = cs_get_type_def(cs, he_base->type);
    var = &i->var;
  }
  else
  {
    // not inherited
    cdef = he->data;
    cst = cs_get_type_def(cs, he->type);
    var = &cdef->var;
  }
 
  if (!cdef || !cst)
    return CSR_ERR_CODE; // LCOV_EXCL_LINE
 
  return cst->string_get(cs, var, cdef, result);
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_str_string_get()

int cs_str_string_get	(	const struct ConfigSet *	cs,
		const char *	name,
		struct Buffer *	result
	)

Get a config item as a string.

Parameters

cs	Config items
name	Name of config item
result	Buffer for results or error messages

Return values

num	Result, e.g. CSR_SUCCESS

Definition at line 706 of file set.c.

{
  if (!cs || !name)
    return CSR_ERR_CODE;
 
  struct HashElem *he = cs_get_elem(cs, name);
  if (!he)
  {
    buf_printf(result, _("Unknown variable '%s'"), name);
    return CSR_ERR_UNKNOWN;
  }
 
  return cs_he_string_get(cs, he, result);
}

Here is the call graph for this function:

cs_he_native_set()

int cs_he_native_set	(	const struct ConfigSet *	cs,
		struct HashElem *	he,
		intptr_t	value,
		struct Buffer *	err
	)

Natively set the value of a HashElem config item.

Parameters

cs	Config items
he	HashElem representing config item
value	Native pointer/value to set
err	Buffer for error messages

Return values

num	Result, e.g. CSR_SUCCESS

Definition at line 729 of file set.c.

{
  if (!cs || !he)
    return CSR_ERR_CODE;
 
  struct ConfigDef *cdef = NULL;
  const struct ConfigSetType *cst = NULL;
  void *var = NULL;
 
  if (he->type & DT_INHERITED)
  {
    struct Inheritance *i = he->data;
    struct HashElem *he_base = cs_get_base(he);
    cdef = he_base->data;
    cst = cs_get_type_def(cs, he_base->type);
    var = &i->var;
  }
  else
  {
    cdef = he->data;
    cst = cs_get_type_def(cs, he->type);
    var = &cdef->var;
  }
 
  if (!cst)
  {
    mutt_debug(LL_DEBUG1, "Variable '%s' has an invalid type %d\n", cdef->name, he->type);
    return CSR_ERR_CODE;
  }
 
  if (!var || !cdef)
    return CSR_ERR_CODE; // LCOV_EXCL_LINE
 
  int rc = cst->native_set(cs, var, cdef, value, err);
  if (CSR_RESULT(rc) != CSR_SUCCESS)
    return rc;
 
  if (he->type & DT_INHERITED)
    he->type = cdef->type | DT_INHERITED;
 
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_str_native_set()

int cs_str_native_set	(	const struct ConfigSet *	cs,
		const char *	name,
		intptr_t	value,
		struct Buffer *	err
	)

Natively set the value of a string config item.

Parameters

cs	Config items
name	Name of config item
value	Native pointer/value to set
err	Buffer for error messages

Return values

num	Result, e.g. CSR_SUCCESS

Definition at line 781 of file set.c.

{
  if (!cs || !name)
    return CSR_ERR_CODE;
 
  struct HashElem *he = cs_get_elem(cs, name);
  if (!he)
  {
    buf_printf(err, _("Unknown variable '%s'"), name);
    return CSR_ERR_UNKNOWN;
  }
 
  struct ConfigDef *cdef = NULL;
  const struct ConfigSetType *cst = NULL;
  void *var = NULL;
 
  if (he->type & DT_INHERITED)
  {
    struct Inheritance *i = he->data;
    struct HashElem *he_base = cs_get_base(he);
    cdef = he_base->data;
    cst = cs_get_type_def(cs, he_base->type);
    var = &i->var;
  }
  else
  {
    cdef = he->data;
    cst = cs_get_type_def(cs, he->type);
    var = &cdef->var;
  }
 
  if (!cst || !var || !cdef)
    return CSR_ERR_CODE; /* LCOV_EXCL_LINE */
 
  int rc = cst->native_set(cs, var, cdef, value, err);
  if (CSR_RESULT(rc) != CSR_SUCCESS)
    return rc;
 
  if (he->type & DT_INHERITED)
    he->type = cdef->type | DT_INHERITED;
 
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_he_native_get()

intptr_t cs_he_native_get	(	const struct ConfigSet *	cs,
		struct HashElem *	he,
		struct Buffer *	err
	)

Natively get the value of a HashElem config item.

Parameters

cs	Config items
he	HashElem representing config item
err	Buffer for results or error messages

Return values

intptr_t	Native pointer/value
INT_MIN	Error

Definition at line 834 of file set.c.

{
  if (!cs || !he)
    return INT_MIN;
 
  struct ConfigDef *cdef = NULL;
  const struct ConfigSetType *cst = NULL;
  void *var = NULL;
 
  if (he->type & DT_INHERITED)
  {
    struct Inheritance *i = he->data;
 
    // inherited, value not set
    if (DTYPE(he->type) == 0)
      return cs_he_native_get(cs, i->parent, err);
 
    // inherited, value set
    struct HashElem *he_base = cs_get_base(he);
    cdef = he_base->data;
    cst = cs_get_type_def(cs, he_base->type);
    var = &i->var;
  }
  else
  {
    // not inherited
    cdef = he->data;
    cst = cs_get_type_def(cs, he->type);
    var = &cdef->var;
  }
 
  if (!var || !cdef)
    return INT_MIN; // LCOV_EXCL_LINE
 
  if (!cst)
  {
    buf_printf(err, _("Variable '%s' has an invalid type %d"), cdef->name, he->type);
    return INT_MIN;
  }
 
  return cst->native_get(cs, var, cdef, err);
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_str_native_get()

intptr_t cs_str_native_get	(	const struct ConfigSet *	cs,
		const char *	name,
		struct Buffer *	err
	)

Natively get the value of a string config item.

Parameters

cs	Config items
name	Name of config item
err	Buffer for error messages

Return values

intptr_t	Native pointer/value
INT_MIN	Error

Definition at line 885 of file set.c.

{
  if (!cs || !name)
    return INT_MIN;
 
  struct HashElem *he = cs_get_elem(cs, name);
  return cs_he_native_get(cs, he, err);
}

Here is the call graph for this function:

cs_he_string_plus_equals()

int cs_he_string_plus_equals	(	const struct ConfigSet *	cs,
		struct HashElem *	he,
		const char *	value,
		struct Buffer *	err
	)

Add to a config item by string.

Parameters

cs	Config items
he	HashElem representing config item
value	Value to set
err	Buffer for error messages

Return values

num	Result, e.g. CSR_SUCCESS

Definition at line 902 of file set.c.

{
  if (!cs || !he)
    return CSR_ERR_CODE;
 
  struct ConfigDef *cdef = NULL;
  const struct ConfigSetType *cst = NULL;
  void *var = NULL;
 
  if (he->type & DT_INHERITED)
  {
    struct Inheritance *i = he->data;
    struct HashElem *he_base = cs_get_base(he);
    cdef = he_base->data;
    cst = cs_get_type_def(cs, he_base->type);
    var = &i->var;
  }
  else
  {
    cdef = he->data;
    cst = cs_get_type_def(cs, he->type);
    var = &cdef->var;
  }
 
  if (!var || !cdef)
    return INT_MIN; // LCOV_EXCL_LINE
 
  if (!cst)
  {
    mutt_debug(LL_DEBUG1, "Variable '%s' has an invalid type %d\n", cdef->name, he->type);
    return CSR_ERR_CODE;
  }
 
  if (!cst->string_plus_equals)
  {
    // L10N: e.g. Type 'boolean' doesn't support operation '+='
    buf_printf(err, _("Type '%s' doesn't support operation '%s'"), cst->name, "+=");
    return CSR_ERR_INVALID | CSV_INV_NOT_IMPL;
  }
 
  int rc = cst->string_plus_equals(cs, var, cdef, value, err);
  if (CSR_RESULT(rc) != CSR_SUCCESS)
    return rc;
 
  if (he->type & DT_INHERITED)
    he->type = cdef->type | DT_INHERITED;
 
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_str_string_plus_equals()

int cs_str_string_plus_equals	(	const struct ConfigSet *	cs,
		const char *	name,
		const char *	value,
		struct Buffer *	err
	)

Add to a config item by string.

Parameters

cs	Config items
name	Name of config item
value	Value to set
err	Buffer for error messages

Return values

num	Result, e.g. CSR_SUCCESS

Definition at line 961 of file set.c.

{
  if (!cs || !name)
    return CSR_ERR_CODE;
 
  struct HashElem *he = cs_get_elem(cs, name);
  if (!he)
  {
    buf_printf(err, _("Unknown variable '%s'"), name);
    return CSR_ERR_UNKNOWN;
  }
 
  return cs_he_string_plus_equals(cs, he, value, err);
}

Here is the call graph for this function:

cs_he_string_minus_equals()

int cs_he_string_minus_equals	(	const struct ConfigSet *	cs,
		struct HashElem *	he,
		const char *	value,
		struct Buffer *	err
	)

Remove from a config item by string.

Parameters

cs	Config items
he	HashElem representing config item
value	Value to set
err	Buffer for error messages

Return values

num	Result, e.g. CSR_SUCCESS

Definition at line 985 of file set.c.

{
  if (!cs || !he)
    return CSR_ERR_CODE;
 
  struct ConfigDef *cdef = NULL;
  const struct ConfigSetType *cst = NULL;
  void *var = NULL;
 
  if (he->type & DT_INHERITED)
  {
    struct Inheritance *i = he->data;
    struct HashElem *he_base = cs_get_base(he);
    cdef = he_base->data;
    cst = cs_get_type_def(cs, he_base->type);
    var = &i->var;
  }
  else
  {
    cdef = he->data;
    cst = cs_get_type_def(cs, he->type);
    var = &cdef->var;
  }
 
  if (!var || !cdef)
    return INT_MIN; // LCOV_EXCL_LINE
 
  if (!cst)
  {
    mutt_debug(LL_DEBUG1, "Variable '%s' has an invalid type %d\n", cdef->name, he->type);
    return CSR_ERR_CODE;
  }
 
  if (!cst->string_minus_equals)
  {
    // L10N: e.g. Type 'boolean' doesn't support operation '+='
    buf_printf(err, _("Type '%s' doesn't support operation '%s'"), cst->name, "-=");
    return CSR_ERR_INVALID | CSV_INV_NOT_IMPL;
  }
 
  int rc = cst->string_minus_equals(cs, var, cdef, value, err);
  if (CSR_RESULT(rc) != CSR_SUCCESS)
    return rc;
 
  if (he->type & DT_INHERITED)
    he->type = cdef->type | DT_INHERITED;
 
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_str_string_minus_equals()

int cs_str_string_minus_equals	(	const struct ConfigSet *	cs,
		const char *	name,
		const char *	value,
		struct Buffer *	err
	)

Remove from a config item by string.

Parameters

cs	Config items
name	Name of config item
value	Value to set
err	Buffer for error messages

Return values

num	Result, e.g. CSR_SUCCESS

Definition at line 1044 of file set.c.

{
  if (!cs || !name)
    return CSR_ERR_CODE;
 
  struct HashElem *he = cs_get_elem(cs, name);
  if (!he)
  {
    buf_printf(err, _("Unknown variable '%s'"), name);
    return CSR_ERR_UNKNOWN;
  }
 
  return cs_he_string_minus_equals(cs, he, value, err);
}

Here is the call graph for this function:

cs_he_delete()

int cs_he_delete	(	const struct ConfigSet *	cs,
		struct HashElem *	he,
		struct Buffer *	err
	)

Delete config item from a config set.

Parameters

cs	Config items
he	HashElem representing config item
err	Buffer for error messages

Return values

num	Result, e.g. CSR_SUCCESS

Definition at line 1067 of file set.c.

{
  if (!cs || !he)
    return CSR_ERR_CODE;
 
  mutt_hash_delete(cs->hash, he->key.strkey, he->data);
  return CSR_SUCCESS;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_str_delete()

int cs_str_delete	(	const struct ConfigSet *	cs,
		const char *	name,
		struct Buffer *	err
	)

Delete config item from a config set.

Parameters

cs	Config items
name	Name of config item
err	Buffer for error messages

Return values

num	Result, e.g. CSR_SUCCESS

Definition at line 1083 of file set.c.

{
  if (!cs || !name)
    return CSR_ERR_CODE;
 
  struct HashElem *he = cs_get_elem(cs, name);
  if (!he)
  {
    buf_printf(err, _("Unknown variable '%s'"), name);
    return CSR_ERR_UNKNOWN;
  }
 
  return cs_he_delete(cs, he, err);
}

Here is the call graph for this function: