helpers.c File Reference

Helper functions to get config values. More...

#include "config.h"
#include <assert.h>
#include <limits.h>
#include <stdbool.h>
#include <stdint.h>
#include <stdlib.h>
#include "mutt/lib.h"
#include "helpers.h"
#include "quad.h"
#include "subset.h"
#include "types.h"

Include dependency graph for helpers.c:

Go to the source code of this file.

Functions
const struct Address *	cs_subset_address (const struct ConfigSubset *sub, const char *name)
	Get an Address config item by name. More...
bool	cs_subset_bool (const struct ConfigSubset *sub, const char *name)
	Get a boolean config item by name. More...
long	cs_subset_long (const struct ConfigSubset *sub, const char *name)
	Get a long config item by name. More...
short	cs_subset_number (const struct ConfigSubset *sub, const char *name)
	Get a number config item by name. More...
const char *	cs_subset_path (const struct ConfigSubset *sub, const char *name)
	Get a path config item by name. More...
enum QuadOption	cs_subset_quad (const struct ConfigSubset *sub, const char *name)
	Get a quad-value config item by name. More...
const struct Regex *	cs_subset_regex (const struct ConfigSubset *sub, const char *name)
	Get a regex config item by name. More...
const struct Slist *	cs_subset_slist (const struct ConfigSubset *sub, const char *name)
	Get a string-list config item by name. More...
short	cs_subset_sort (const struct ConfigSubset *sub, const char *name)
	Get a sort config item by name. More...
const char *	cs_subset_string (const struct ConfigSubset *sub, const char *name)
	Get a string config item by name. More...

Detailed Description

Helper functions to get config values.

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

Function Documentation

cs_subset_address()

const struct Address* cs_subset_address	(	const struct ConfigSubset *	sub,
		const char *	name
	)

Get an Address config item by name.

Parameters

sub	Config Subset
name	Name of config item

Return values

ptr	Address
NULL	Empty address

Definition at line 48 of file helpers.c.

{
  assert(sub && name);

  struct HashElem *he = cs_subset_create_inheritance(sub, name);
  assert(he);

  assert(DTYPE(he->type) == DT_ADDRESS);

  intptr_t value = cs_subset_he_native_get(sub, he, NULL);
  assert(value != INT_MIN);

  return (const struct Address *) value;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_subset_bool()

bool cs_subset_bool	(	const struct ConfigSubset *	sub,
		const char *	name
	)

Get a boolean config item by name.

Parameters

sub	Config Subset
name	Name of config item

Return values

bool

Boolean

Definition at line 69 of file helpers.c.

{
  assert(sub && name);

  struct HashElem *he = cs_subset_create_inheritance(sub, name);
  assert(he);

  assert(DTYPE(he->type) == DT_BOOL);

  intptr_t value = cs_subset_he_native_get(sub, he, NULL);
  assert(value != INT_MIN);

  return (bool) value;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_subset_long()

long cs_subset_long	(	const struct ConfigSubset *	sub,
		const char *	name
	)

Get a long config item by name.

Parameters

sub	Config Subset
name	Name of config item

Return values

num	Long value

Definition at line 90 of file helpers.c.

{
  assert(sub && name);

  struct HashElem *he = cs_subset_create_inheritance(sub, name);
  assert(he);

  assert(DTYPE(he->type) == DT_LONG);

  intptr_t value = cs_subset_he_native_get(sub, he, NULL);
  assert(value != INT_MIN);

  return (long) value;
}

Here is the call graph for this function:

cs_subset_number()

short cs_subset_number	(	const struct ConfigSubset *	sub,
		const char *	name
	)

Get a number config item by name.

Parameters

sub	Config Subset
name	Name of config item

Return values

num

Number

Definition at line 111 of file helpers.c.

{
  assert(sub && name);

  struct HashElem *he = cs_subset_create_inheritance(sub, name);
  assert(he);

  assert(DTYPE(he->type) == DT_NUMBER);

  intptr_t value = cs_subset_he_native_get(sub, he, NULL);
  assert(value != INT_MIN);

  return (short) value;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_subset_path()

const char* cs_subset_path	(	const struct ConfigSubset *	sub,
		const char *	name
	)

Get a path config item by name.

Parameters

sub	Config Subset
name	Name of config item

Return values

ptr	Path
NULL	Empty path

Definition at line 133 of file helpers.c.

{
  assert(sub && name);

  struct HashElem *he = cs_subset_create_inheritance(sub, name);
  assert(he);

  assert(DTYPE(he->type) == DT_PATH);

  intptr_t value = cs_subset_he_native_get(sub, he, NULL);
  assert(value != INT_MIN);

  return (const char *) value;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_subset_quad()

enum QuadOption cs_subset_quad	(	const struct ConfigSubset *	sub,
		const char *	name
	)

Get a quad-value config item by name.

Parameters

sub	Config Subset
name	Name of config item

Return values

num	Quad-value

Definition at line 154 of file helpers.c.

{
  assert(sub && name);

  struct HashElem *he = cs_subset_create_inheritance(sub, name);
  assert(he);

  assert(DTYPE(he->type) == DT_QUAD);

  intptr_t value = cs_subset_he_native_get(sub, he, NULL);
  assert(value != INT_MIN);

  return (enum QuadOption) value;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_subset_regex()

const struct Regex* cs_subset_regex	(	const struct ConfigSubset *	sub,
		const char *	name
	)

Get a regex config item by name.

Parameters

sub	Config Subset
name	Name of config item

Return values

ptr	Regex
NULL	Empty regex

Definition at line 176 of file helpers.c.

{
  assert(sub && name);

  struct HashElem *he = cs_subset_create_inheritance(sub, name);
  assert(he);

  assert(DTYPE(he->type) == DT_REGEX);

  intptr_t value = cs_subset_he_native_get(sub, he, NULL);
  assert(value != INT_MIN);

  return (const struct Regex *) value;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_subset_slist()

const struct Slist* cs_subset_slist	(	const struct ConfigSubset *	sub,
		const char *	name
	)

Get a string-list config item by name.

Parameters

sub	Config Subset
name	Name of config item

Return values

ptr	String list
NULL	Empty string list

Definition at line 198 of file helpers.c.

{
  assert(sub && name);

  struct HashElem *he = cs_subset_create_inheritance(sub, name);
  assert(he);

  assert(DTYPE(he->type) == DT_SLIST);

  intptr_t value = cs_subset_he_native_get(sub, he, NULL);
  assert(value != INT_MIN);

  return (const struct Slist *) value;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_subset_sort()

short cs_subset_sort	(	const struct ConfigSubset *	sub,
		const char *	name
	)

Get a sort config item by name.

Parameters

sub	Config Subset
name	Name of config item

Return values

num

Sort

Definition at line 219 of file helpers.c.

{
  assert(sub && name);

  struct HashElem *he = cs_subset_create_inheritance(sub, name);
  assert(he);

  assert(DTYPE(he->type) == DT_SORT);

  intptr_t value = cs_subset_he_native_get(sub, he, NULL);
  assert(value != INT_MIN);

  return (short) value;
}

Here is the call graph for this function:

Here is the caller graph for this function:

cs_subset_string()

const char* cs_subset_string	(	const struct ConfigSubset *	sub,
		const char *	name
	)

Get a string config item by name.

Parameters

sub	Config Subset
name	Name of config item

Return values

ptr	String
NULL	Empty string

Definition at line 241 of file helpers.c.

{
  assert(sub && name);

  struct HashElem *he = cs_subset_create_inheritance(sub, name);
  assert(he);

  assert(DTYPE(he->type) == DT_STRING);

  intptr_t value = cs_subset_he_native_get(sub, he, NULL);
  assert(value != INT_MIN);

  return (const char *) value;
}

Here is the call graph for this function:

Here is the caller graph for this function: