NeoMutt  2025-05-10
Teaching an old dog new tricks
 		DOXYGEN
Loading...
Searching...
No Matches
Functions
string_set()
Config Type API

Set a config item by string. More...

+ Collaboration diagram for string_set():

Functions

static int address_string_set (void *var, struct ConfigDef *cdef, const char *value, struct Buffer *err)
 Set an Address by string - Implements ConfigSetType::string_set() -.
 
static int bool_string_set (void *var, struct ConfigDef *cdef, const char *value, struct Buffer *err)
 Set a Bool by string - Implements ConfigSetType::string_set() -.
 
static int enum_string_set (void *var, struct ConfigDef *cdef, const char *value, struct Buffer *err)
 Set an Enumeration by string - Implements ConfigSetType::string_set() -.
 
static int long_string_set (void *var, struct ConfigDef *cdef, const char *value, struct Buffer *err)
 Set a Long by string - Implements ConfigSetType::string_set() -.
 
static int mbtable_string_set (void *var, struct ConfigDef *cdef, const char *value, struct Buffer *err)
 Set an MbTable by string - Implements ConfigSetType::string_set() -.
 
static int myvar_string_set (void *var, struct ConfigDef *cdef, const char *value, struct Buffer *err)
 Set a MyVar by string - Implements ConfigSetType::string_set() -.
 
static int number_string_set (void *var, struct ConfigDef *cdef, const char *value, struct Buffer *err)
 Set a Number by string - Implements ConfigSetType::string_set() -.
 
static int path_string_set (void *var, struct ConfigDef *cdef, const char *value, struct Buffer *err)
 Set a Path by string - Implements ConfigSetType::string_set() -.
 
static int quad_string_set (void *var, struct ConfigDef *cdef, const char *value, struct Buffer *err)
 Set a Quad-option by string - Implements ConfigSetType::string_set() -.
 
static int regex_string_set (void *var, struct ConfigDef *cdef, const char *value, struct Buffer *err)
 Set a Regex by string - Implements ConfigSetType::string_set() -.
 
static int slist_string_set (void *var, struct ConfigDef *cdef, const char *value, struct Buffer *err)
 Set a Slist by string - Implements ConfigSetType::string_set() -.
 
static int sort_string_set (void *var, struct ConfigDef *cdef, const char *value, struct Buffer *err)
 Set a Sort by string - Implements ConfigSetType::string_set() -.
 
static int string_string_set (void *var, struct ConfigDef *cdef, const char *value, struct Buffer *err)
 Set a String by string - Implements ConfigSetType::string_set() -.
 
static int expando_string_set (void *var, struct ConfigDef *cdef, const char *value, struct Buffer *err)
 Set an Expando by string - Implements ConfigSetType::string_set() -.
 

Detailed Description

Set a config item by string.

Parameters
varVariable to set (may be NULL)
cdefVariable definition
valueValue to set (may be NULL)
errBuffer for error messages (may be NULL)
Return values
numResult, e.g. CSR_SUCCESS

If var is NULL, then the config item's initial value will be set.

Precondition
cdef is not NULL

Function Documentation

◆ address_string_set()

static int address_string_set ( void *  var,
struct ConfigDef *  cdef,
const char *  value,
struct Buffer *  err 
)
static

Set an Address by string - Implements ConfigSetType::string_set() -.

Definition at line 74 of file config_type.c.

76{
77 /* Store empty address as NULL */
78 if (value && (value[0] == '\0'))
79 value = NULL;
80
81 struct Address *addr = NULL;
82
83 int rc = CSR_SUCCESS;
84
85 if (!value && (cdef->type & D_NOT_EMPTY))
86 {
87 buf_printf(err, _("Option %s may not be empty"), cdef->name);
88 return CSR_ERR_INVALID | CSR_INV_VALIDATOR;
89 }
90
91 if (var && value)
92 {
93 // TODO - config can only store one
94 struct AddressList al = TAILQ_HEAD_INITIALIZER(al);
95 mutt_addrlist_parse(&al, value);
96 addr = mutt_addr_copy(TAILQ_FIRST(&al));
97 mutt_addrlist_clear(&al);
98 }
99
100 if (var)
101 {
102 if (cdef->validator)
103 {
104 rc = cdef->validator(cdef, (intptr_t) addr, err);
105
106 if (CSR_RESULT(rc) != CSR_SUCCESS)
107 {
108 address_destroy(&addr, cdef);
109 return rc | CSR_INV_VALIDATOR;
110 }
111 }
112
113 /* ordinary variable setting */
114 address_destroy(var, cdef);
115
116 *(struct Address **) var = addr;
117
118 if (!addr)
119 rc |= CSR_SUC_EMPTY;
120 }
121 else
122 {
123 /* set the default/initial value */
124 if (cdef->type & D_INTERNAL_INITIAL_SET)
125 FREE(&cdef->initial);
126
127 cdef->type |= D_INTERNAL_INITIAL_SET;
128 cdef->initial = (intptr_t) mutt_str_dup(value);
129 }
130
131 return rc;
132}
mutt_addrlist_clear
void mutt_addrlist_clear(struct AddressList *al)
Unlink and free all Address in an AddressList.
Definition: address.c:1460
mutt_addr_copy
struct Address * mutt_addr_copy(const struct Address *addr)
Copy the real address.
Definition: address.c:745
mutt_addrlist_parse
int mutt_addrlist_parse(struct AddressList *al, const char *s)
Parse a list of email addresses.
Definition: address.c:480
buf_printf
int buf_printf(struct Buffer *buf, const char *fmt,...)
Format a string overwriting a Buffer.
Definition: buffer.c:161
CSR_ERR_INVALID
#define CSR_ERR_INVALID
Value hasn't been set.
Definition: set.h:36
CSR_INV_VALIDATOR
#define CSR_INV_VALIDATOR
Value was rejected by the validator.
Definition: set.h:46
CSR_RESULT
#define CSR_RESULT(x)
Definition: set.h:50
CSR_SUC_EMPTY
#define CSR_SUC_EMPTY
Value is empty/unset.
Definition: set.h:40
CSR_SUCCESS
#define CSR_SUCCESS
Action completed successfully.
Definition: set.h:33
address_destroy
static void address_destroy(void *var, const struct ConfigDef *cdef)
Destroy an Address object - Implements ConfigSetType::destroy() -.
Definition: config_type.c:62
FREE
#define FREE(x)
Definition: memory.h:55
_
#define _(a)
Definition: message.h:28
mutt_str_dup
char * mutt_str_dup(const char *str)
Copy a string, safely.
Definition: string.c:254
TAILQ_FIRST
#define TAILQ_FIRST(head)
Definition: queue.h:780
TAILQ_HEAD_INITIALIZER
#define TAILQ_HEAD_INITIALIZER(head)
Definition: queue.h:694
Address
An email address.
Definition: address.h:36
ConfigDef::name
const char * name
User-visible name.
Definition: set.h:63
ConfigDef::validator
int(* validator)(const struct ConfigDef *cdef, intptr_t value, struct Buffer *err)
Definition: set.h:79
ConfigDef::initial
intptr_t initial
Initial value.
Definition: set.h:65
ConfigDef::type
uint32_t type
Variable type, e.g. DT_STRING.
Definition: set.h:64
D_INTERNAL_INITIAL_SET
#define D_INTERNAL_INITIAL_SET
Config item must have its initial value freed.
Definition: types.h:89
D_NOT_EMPTY
#define D_NOT_EMPTY
Empty strings are not allowed.
Definition: types.h:79
+ Here is the call graph for this function:

◆ bool_string_set()

static int bool_string_set ( void *  var,
struct ConfigDef *  cdef,
const char *  value,
struct Buffer *  err 
)
static

Set a Bool by string - Implements ConfigSetType::string_set() -.

Definition at line 58 of file bool.c.

60{
61 if (!value)
62 return CSR_ERR_CODE; /* LCOV_EXCL_LINE */
63
64 int num = -1;
65 for (size_t i = 0; BoolValues[i]; i++)
66 {
67 if (mutt_istr_equal(BoolValues[i], value))
68 {
69 num = i % 2;
70 break;
71 }
72 }
73
74 if (num < 0)
75 {
76 buf_printf(err, _("Invalid boolean value: %s"), value);
77 return CSR_ERR_INVALID | CSR_INV_TYPE;
78 }
79
80 if (var)
81 {
82 if (num == (*(bool *) var))
83 return CSR_SUCCESS | CSR_SUC_NO_CHANGE;
84
85 if (startup_only(cdef, err))
86 return CSR_ERR_INVALID | CSR_INV_VALIDATOR;
87
88 if (cdef->validator)
89 {
90 int rc = cdef->validator(cdef, (intptr_t) num, err);
91
92 if (CSR_RESULT(rc) != CSR_SUCCESS)
93 return rc | CSR_INV_VALIDATOR;
94 }
95
96 *(bool *) var = num;
97 }
98 else
99 {
100 cdef->initial = num;
101 }
102
103 return CSR_SUCCESS;
104}
BoolValues
const char * BoolValues[]
Valid strings for creating a Bool.
Definition: bool.c:51
startup_only
static bool startup_only(const struct ConfigDef *cdef, struct Buffer *err)
Validator function for D_ON_STARTUP.
Definition: set.h:293
CSR_INV_TYPE
#define CSR_INV_TYPE
Value is not valid for the type.
Definition: set.h:45
CSR_SUC_NO_CHANGE
#define CSR_SUC_NO_CHANGE
The value hasn't changed.
Definition: set.h:42
CSR_ERR_CODE
#define CSR_ERR_CODE
Problem with the code.
Definition: set.h:34
mutt_istr_equal
bool mutt_istr_equal(const char *a, const char *b)
Compare two strings, ignoring case.
Definition: string.c:673
+ Here is the call graph for this function:

◆ enum_string_set()

static int enum_string_set ( void *  var,
struct ConfigDef *  cdef,
const char *  value,
struct Buffer *  err 
)
static

Set an Enumeration by string - Implements ConfigSetType::string_set() -.

Definition at line 45 of file enum.c.

47{
48 if (!value)
49 return CSR_ERR_CODE; /* LCOV_EXCL_LINE */
50
51 struct EnumDef *ed = (struct EnumDef *) cdef->data;
52 if (!ed || !ed->lookup)
53 return CSR_ERR_CODE;
54
55 int num = mutt_map_get_value(value, ed->lookup);
56 if (num < 0)
57 {
58 buf_printf(err, _("Invalid enum value: %s"), value);
59 return CSR_ERR_INVALID | CSR_INV_TYPE;
60 }
61
62 if (var)
63 {
64 if (num == (*(unsigned char *) var))
65 return CSR_SUCCESS | CSR_SUC_NO_CHANGE;
66
67 if (startup_only(cdef, err))
68 return CSR_ERR_INVALID | CSR_INV_VALIDATOR;
69
70 if (cdef->validator)
71 {
72 int rc = cdef->validator(cdef, (intptr_t) num, err);
73
74 if (CSR_RESULT(rc) != CSR_SUCCESS)
75 return rc | CSR_INV_VALIDATOR;
76 }
77
78 *(unsigned char *) var = num;
79 }
80 else
81 {
82 cdef->initial = num;
83 }
84
85 return CSR_SUCCESS;
86}
mutt_map_get_value
int mutt_map_get_value(const char *name, const struct Mapping *map)
Lookup the constant for a string.
Definition: mapping.c:85
ConfigDef::data
intptr_t data
Extra variable data.
Definition: set.h:66
EnumDef
An enumeration.
Definition: enum.h:30
EnumDef::lookup
struct Mapping * lookup
Lookup table.
Definition: enum.h:33
+ Here is the call graph for this function:

◆ long_string_set()

static int long_string_set ( void *  var,
struct ConfigDef *  cdef,
const char *  value,
struct Buffer *  err 
)
static

Set a Long by string - Implements ConfigSetType::string_set() -.

Definition at line 46 of file long.c.

48{
49 if (!value || (value[0] == '\0'))
50 {
51 buf_printf(err, _("Option %s may not be empty"), cdef->name);
52 return CSR_ERR_INVALID | CSR_INV_TYPE;
53 }
54
55 long num = 0;
56 if (!mutt_str_atol_full(value, &num))
57 {
58 buf_printf(err, _("Invalid long: %s"), value);
59 return CSR_ERR_INVALID | CSR_INV_TYPE;
60 }
61
62 if ((num < 0) && (cdef->type & D_INTEGER_NOT_NEGATIVE))
63 {
64 buf_printf(err, _("Option %s may not be negative"), cdef->name);
65 return CSR_ERR_INVALID | CSR_INV_VALIDATOR;
66 }
67
68 if (var)
69 {
70 if (num == (*(long *) var))
71 return CSR_SUCCESS | CSR_SUC_NO_CHANGE;
72
73 if (startup_only(cdef, err))
74 return CSR_ERR_INVALID | CSR_INV_VALIDATOR;
75
76 if (cdef->validator)
77 {
78 int rc = cdef->validator(cdef, (intptr_t) num, err);
79
80 if (CSR_RESULT(rc) != CSR_SUCCESS)
81 return rc | CSR_INV_VALIDATOR;
82 }
83
84 *(long *) var = num;
85 }
86 else
87 {
88 cdef->initial = num;
89 }
90
91 return CSR_SUCCESS;
92}
D_INTEGER_NOT_NEGATIVE
#define D_INTEGER_NOT_NEGATIVE
Negative numbers are not allowed.
Definition: types.h:100
+ Here is the call graph for this function:

◆ mbtable_string_set()

static int mbtable_string_set ( void *  var,
struct ConfigDef *  cdef,
const char *  value,
struct Buffer *  err 
)
static

Set an MbTable by string - Implements ConfigSetType::string_set() -.

Definition at line 122 of file mbtable.c.

124{
125 /* Store empty mbtables as NULL */
126 if (value && (value[0] == '\0'))
127 value = NULL;
128
129 struct MbTable *table = NULL;
130
131 int rc = CSR_SUCCESS;
132
133 if (var)
134 {
135 struct MbTable *curval = *(struct MbTable **) var;
136 if (curval && mutt_str_equal(value, curval->orig_str))
137 return CSR_SUCCESS | CSR_SUC_NO_CHANGE;
138
139 if (startup_only(cdef, err))
140 return CSR_ERR_INVALID | CSR_INV_VALIDATOR;
141
142 table = mbtable_parse(value);
143
144 if (cdef->validator)
145 {
146 rc = cdef->validator(cdef, (intptr_t) table, err);
147
148 if (CSR_RESULT(rc) != CSR_SUCCESS)
149 {
150 mbtable_free(&table);
151 return rc | CSR_INV_VALIDATOR;
152 }
153 }
154
155 mbtable_destroy(var, cdef);
156
157 *(struct MbTable **) var = table;
158
159 if (!table)
160 rc |= CSR_SUC_EMPTY;
161 }
162 else
163 {
164 if (cdef->type & D_INTERNAL_INITIAL_SET)
165 FREE(&cdef->initial);
166
167 cdef->type |= D_INTERNAL_INITIAL_SET;
168 cdef->initial = (intptr_t) mutt_str_dup(value);
169 }
170
171 return rc;
172}
mbtable_destroy
static void mbtable_destroy(void *var, const struct ConfigDef *cdef)
Destroy an MbTable object - Implements ConfigSetType::destroy() -.
Definition: mbtable.c:110
mbtable_parse
struct MbTable * mbtable_parse(const char *s)
Parse a multibyte string into a table.
Definition: mbtable.c:66
mbtable_free
void mbtable_free(struct MbTable **ptr)
Free an MbTable object.
Definition: mbtable.c:317
mutt_str_equal
bool mutt_str_equal(const char *a, const char *b)
Compare two strings.
Definition: string.c:661
MbTable
Multibyte character table.
Definition: mbtable.h:36
MbTable::orig_str
char * orig_str
Original string used to generate this object.
Definition: mbtable.h:37
+ Here is the call graph for this function:

◆ myvar_string_set()

static int myvar_string_set ( void *  var,
struct ConfigDef *  cdef,
const char *  value,
struct Buffer *  err 
)
static

Set a MyVar by string - Implements ConfigSetType::string_set() -.

Definition at line 57 of file myvar.c.

59{
60 /* Store empty myvars as NULL */
61 if (value && (value[0] == '\0'))
62 value = NULL;
63
64 int rc = CSR_SUCCESS;
65
66 if (var)
67 {
68 if (mutt_str_equal(value, (*(char **) var)))
69 return CSR_SUCCESS | CSR_SUC_NO_CHANGE;
70
71 myvar_destroy(var, cdef);
72
73 const char *str = mutt_str_dup(value);
74 if (!str)
75 rc |= CSR_SUC_EMPTY;
76
77 *(const char **) var = str;
78 }
79 else
80 {
81 if (cdef->type & D_INTERNAL_INITIAL_SET)
82 FREE(&cdef->initial);
83
84 cdef->type |= D_INTERNAL_INITIAL_SET;
85 cdef->initial = (intptr_t) mutt_str_dup(value);
86 }
87
88 return rc;
89}
myvar_destroy
static void myvar_destroy(void *var, const struct ConfigDef *cdef)
Destroy a MyVar - Implements ConfigSetType::destroy() -.
Definition: myvar.c:45
+ Here is the call graph for this function:

◆ number_string_set()

static int number_string_set ( void *  var,
struct ConfigDef *  cdef,
const char *  value,
struct Buffer *  err 
)
static

Set a Number by string - Implements ConfigSetType::string_set() -.

Definition at line 79 of file number.c.

81{
82 int num = 0;
83 if (value && *value && !mutt_str_atoi_full(value, &num))
84 {
85 buf_printf(err, _("Invalid number: %s"), value);
86 return CSR_ERR_INVALID | CSR_INV_TYPE;
87 }
88
89 if ((num < SHRT_MIN) || (num > SHRT_MAX))
90 {
91 buf_printf(err, _("Number is too big: %s"), value);
92 return CSR_ERR_INVALID | CSR_INV_TYPE;
93 }
94
95 if ((num < 0) && (cdef->type & D_INTEGER_NOT_NEGATIVE))
96 {
97 buf_printf(err, _("Option %s may not be negative"), cdef->name);
98 return CSR_ERR_INVALID | CSR_INV_VALIDATOR;
99 }
100
101 if (var)
102 {
103 if (num == native_get(var))
104 return CSR_SUCCESS | CSR_SUC_NO_CHANGE;
105
106 if (cdef->validator)
107 {
108 int rc = cdef->validator(cdef, (intptr_t) num, err);
109
110 if (CSR_RESULT(rc) != CSR_SUCCESS)
111 return rc | CSR_INV_VALIDATOR;
112 }
113
114 if (startup_only(cdef, err))
115 return CSR_ERR_INVALID | CSR_INV_VALIDATOR;
116
117 native_set(var, num);
118 }
119 else
120 {
121 cdef->initial = num;
122 }
123
124 return CSR_SUCCESS;
125}
native_set
static void native_set(void *var, intptr_t val)
Set an int into a Number config item.
Definition: number.c:61
native_get
static intptr_t native_get(void *var)
Get an int from a Number config item.
Definition: number.c:51
+ Here is the call graph for this function:

◆ path_string_set()

static int path_string_set ( void *  var,
struct ConfigDef *  cdef,
const char *  value,
struct Buffer *  err 
)
static

Set a Path by string - Implements ConfigSetType::string_set() -.

Definition at line 89 of file path.c.

91{
92 /* Store empty paths as NULL */
93 if (value && (value[0] == '\0'))
94 value = NULL;
95
96 if (!value && (cdef->type & D_NOT_EMPTY))
97 {
98 buf_printf(err, _("Option %s may not be empty"), cdef->name);
99 return CSR_ERR_INVALID | CSR_INV_VALIDATOR;
100 }
101
102 int rc = CSR_SUCCESS;
103
104 if (var)
105 {
106 if (mutt_str_equal(value, (*(char **) var)))
107 return CSR_SUCCESS | CSR_SUC_NO_CHANGE;
108
109 if (startup_only(cdef, err))
110 return CSR_ERR_INVALID | CSR_INV_VALIDATOR;
111
112 if (cdef->validator)
113 {
114 rc = cdef->validator(cdef, (intptr_t) value, err);
115
116 if (CSR_RESULT(rc) != CSR_SUCCESS)
117 return rc | CSR_INV_VALIDATOR;
118 }
119
120 path_destroy(var, cdef);
121
122 const char *str = path_tidy(value, cdef->type & D_PATH_DIR);
123 if (!str)
124 rc |= CSR_SUC_EMPTY;
125
126 *(const char **) var = str;
127 }
128 else
129 {
130 if (cdef->type & D_INTERNAL_INITIAL_SET)
131 FREE(&cdef->initial);
132
133 cdef->type |= D_INTERNAL_INITIAL_SET;
134 cdef->initial = (intptr_t) mutt_str_dup(value);
135 }
136
137 return rc;
138}
path_tidy
static char * path_tidy(const char *path, bool is_dir)
Tidy a path for storage.
Definition: path.c:57
path_destroy
static void path_destroy(void *var, const struct ConfigDef *cdef)
Destroy a Path - Implements ConfigSetType::destroy() -.
Definition: path.c:77
D_PATH_DIR
#define D_PATH_DIR
Path is a directory.
Definition: types.h:102
+ Here is the call graph for this function:

◆ quad_string_set()

static int quad_string_set ( void *  var,
struct ConfigDef *  cdef,
const char *  value,
struct Buffer *  err 
)
static

Set a Quad-option by string - Implements ConfigSetType::string_set() -.

Definition at line 61 of file quad.c.

63{
64 if (!value)
65 return CSR_ERR_CODE; /* LCOV_EXCL_LINE */
66
67 int num = -1;
68 for (size_t i = 0; QuadValues[i]; i++)
69 {
70 if (mutt_istr_equal(QuadValues[i], value))
71 {
72 num = i;
73 break;
74 }
75 }
76
77 if (num < 0)
78 {
79 buf_printf(err, _("Invalid quad value: %s"), value);
80 return CSR_ERR_INVALID | CSR_INV_TYPE;
81 }
82
83 if (var)
84 {
85 if (num == (*(char *) var))
86 return CSR_SUCCESS | CSR_SUC_NO_CHANGE;
87
88 if (startup_only(cdef, err))
89 return CSR_ERR_INVALID | CSR_INV_VALIDATOR;
90
91 if (cdef->validator)
92 {
93 int rc = cdef->validator(cdef, (intptr_t) num, err);
94
95 if (CSR_RESULT(rc) != CSR_SUCCESS)
96 return rc | CSR_INV_VALIDATOR;
97 }
98
99 *(char *) var = num;
100 }
101 else
102 {
103 cdef->initial = num;
104 }
105
106 return CSR_SUCCESS;
107}
QuadValues
const char * QuadValues[]
Valid strings for creating a QuadValue.
Definition: quad.c:54
+ Here is the call graph for this function:

◆ regex_string_set()

static int regex_string_set ( void *  var,
struct ConfigDef *  cdef,
const char *  value,
struct Buffer *  err 
)
static

Set a Regex by string - Implements ConfigSetType::string_set() -.

Definition at line 142 of file regex.c.

144{
145 /* Store empty regexes as NULL */
146 if (value && (value[0] == '\0'))
147 value = NULL;
148
149 struct Regex *r = NULL;
150
151 int rc = CSR_SUCCESS;
152
153 if (var)
154 {
155 struct Regex *curval = *(struct Regex **) var;
156 if (curval && mutt_str_equal(value, curval->pattern))
157 return CSR_SUCCESS | CSR_SUC_NO_CHANGE;
158
159 if (startup_only(cdef, err))
160 return CSR_ERR_INVALID | CSR_INV_VALIDATOR;
161
162 if (value)
163 {
164 r = regex_new(value, cdef->type, err);
165 if (!r)
166 return CSR_ERR_INVALID;
167 }
168
169 if (cdef->validator)
170 {
171 rc = cdef->validator(cdef, (intptr_t) r, err);
172
173 if (CSR_RESULT(rc) != CSR_SUCCESS)
174 {
175 regex_free(&r);
176 return rc | CSR_INV_VALIDATOR;
177 }
178 }
179
180 regex_destroy(var, cdef);
181
182 *(struct Regex **) var = r;
183
184 if (!r)
185 rc |= CSR_SUC_EMPTY;
186 }
187 else
188 {
189 if (cdef->type & D_INTERNAL_INITIAL_SET)
190 FREE(&cdef->initial);
191
192 cdef->type |= D_INTERNAL_INITIAL_SET;
193 cdef->initial = (intptr_t) mutt_str_dup(value);
194 }
195
196 return rc;
197}
regex_new
struct Regex * regex_new(const char *str, uint32_t flags, struct Buffer *err)
Create an Regex from a string.
Definition: regex.c:102
regex_free
void regex_free(struct Regex **ptr)
Free a Regex object.
Definition: regex.c:68
regex_destroy
static void regex_destroy(void *var, const struct ConfigDef *cdef)
Destroy a Regex object - Implements ConfigSetType::destroy() -.
Definition: regex.c:85
Regex
Cached regular expression.
Definition: regex3.h:86
Regex::pattern
char * pattern
printable version
Definition: regex3.h:87
+ Here is the call graph for this function:

◆ slist_string_set()

static int slist_string_set ( void *  var,
struct ConfigDef *  cdef,
const char *  value,
struct Buffer *  err 
)
static

Set a Slist by string - Implements ConfigSetType::string_set() -.

Definition at line 59 of file slist.c.

61{
62 /* Store empty string list as NULL */
63 if (value && (value[0] == '\0'))
64 value = NULL;
65
66 struct Slist *list = NULL;
67
68 int rc = CSR_SUCCESS;
69
70 if (var)
71 {
72 list = slist_parse(value, cdef->type);
73
74 if (slist_equal(list, *(struct Slist **) var))
75 {
76 slist_free(&list);
77 return CSR_SUCCESS | CSR_SUC_NO_CHANGE;
78 }
79
80 if (startup_only(cdef, err))
81 {
82 slist_free(&list);
83 return CSR_ERR_INVALID | CSR_INV_VALIDATOR;
84 }
85
86 if (cdef->validator)
87 {
88 rc = cdef->validator(cdef, (intptr_t) list, err);
89
90 if (CSR_RESULT(rc) != CSR_SUCCESS)
91 {
92 slist_free(&list);
93 return rc | CSR_INV_VALIDATOR;
94 }
95 }
96
97 slist_destroy(var, cdef);
98
99 *(struct Slist **) var = list;
100
101 if (!list)
102 rc |= CSR_SUC_EMPTY;
103 }
104 else
105 {
106 if (cdef->type & D_INTERNAL_INITIAL_SET)
107 FREE(&cdef->initial);
108
109 cdef->type |= D_INTERNAL_INITIAL_SET;
110 cdef->initial = (intptr_t) mutt_str_dup(value);
111 }
112
113 return rc;
114}
slist_destroy
static void slist_destroy(void *var, const struct ConfigDef *cdef)
Destroy an Slist object - Implements ConfigSetType::destroy() -.
Definition: slist.c:47
slist_parse
struct Slist * slist_parse(const char *str, uint32_t flags)
Parse a list of strings into a list.
Definition: slist.c:177
slist_free
void slist_free(struct Slist **ptr)
Free an Slist object.
Definition: slist.c:124
slist_equal
bool slist_equal(const struct Slist *a, const struct Slist *b)
Compare two string lists.
Definition: slist.c:91
Slist
String list.
Definition: slist.h:37
+ Here is the call graph for this function:

◆ sort_string_set()

static int sort_string_set ( void *  var,
struct ConfigDef *  cdef,
const char *  value,
struct Buffer *  err 
)
static

Set a Sort by string - Implements ConfigSetType::string_set() -.

Definition at line 50 of file sort.c.

52{
53 intptr_t id = -1;
54 uint16_t flags = 0;
55
56 if (!value || (value[0] == '\0'))
57 {
58 buf_printf(err, _("Option %s may not be empty"), cdef->name);
59 return CSR_ERR_INVALID | CSR_INV_TYPE;
60 }
61
62 size_t plen = 0;
63
64 if (cdef->type & D_SORT_REVERSE)
65 {
66 plen = mutt_str_startswith(value, PREFIX_REVERSE);
67 if (plen != 0)
68 {
69 flags |= SORT_REVERSE;
70 value += plen;
71 }
72 }
73
74 if (cdef->type & D_SORT_LAST)
75 {
76 plen = mutt_str_startswith(value, PREFIX_LAST);
77 if (plen != 0)
78 {
79 flags |= SORT_LAST;
80 value += plen;
81 }
82 }
83
84 id = mutt_map_get_value(value, (struct Mapping *) cdef->data);
85
86 if (id < 0)
87 {
88 buf_printf(err, _("Invalid sort name: %s"), value);
89 return CSR_ERR_INVALID | CSR_INV_TYPE;
90 }
91
92 id |= flags;
93
94 if (var)
95 {
96 if (id == (*(short *) var))
97 return CSR_SUCCESS | CSR_SUC_NO_CHANGE;
98
99 if (startup_only(cdef, err))
100 return CSR_ERR_INVALID | CSR_INV_VALIDATOR;
101
102 if (cdef->validator)
103 {
104 int rc = cdef->validator(cdef, (intptr_t) id, err);
105
106 if (CSR_RESULT(rc) != CSR_SUCCESS)
107 return rc | CSR_INV_VALIDATOR;
108 }
109
110 *(short *) var = id;
111 }
112 else
113 {
114 cdef->initial = id;
115 }
116
117 return CSR_SUCCESS;
118}
PREFIX_REVERSE
#define PREFIX_REVERSE
Definition: sort.c:44
PREFIX_LAST
#define PREFIX_LAST
Definition: sort.c:45
SORT_LAST
#define SORT_LAST
Sort thread by last-X, e.g. received date.
Definition: sort.h:40
SORT_REVERSE
#define SORT_REVERSE
Reverse the order of the sort.
Definition: sort.h:39
mutt_str_startswith
size_t mutt_str_startswith(const char *str, const char *prefix)
Check whether a string starts with a prefix.
Definition: string.c:231
Mapping
Mapping between user-readable string and a constant.
Definition: mapping.h:33
D_SORT_LAST
#define D_SORT_LAST
Sort flag for -last prefix.
Definition: types.h:118
D_SORT_REVERSE
#define D_SORT_REVERSE
Sort flag for -reverse prefix.
Definition: types.h:119
+ Here is the call graph for this function:

◆ string_string_set()

static int string_string_set ( void *  var,
struct ConfigDef *  cdef,
const char *  value,
struct Buffer *  err 
)
static

Set a String by string - Implements ConfigSetType::string_set() -.

Definition at line 60 of file string.c.

62{
63 /* Store empty strings as NULL */
64 if (value && (value[0] == '\0'))
65 value = NULL;
66
67 if (!value && (cdef->type & D_NOT_EMPTY))
68 {
69 buf_printf(err, _("Option %s may not be empty"), cdef->name);
70 return CSR_ERR_INVALID | CSR_INV_VALIDATOR;
71 }
72
73 int rc = CSR_SUCCESS;
74
75 if (var)
76 {
77 if (mutt_str_equal(value, (*(char **) var)))
78 return CSR_SUCCESS | CSR_SUC_NO_CHANGE;
79
80 if (startup_only(cdef, err))
81 return CSR_ERR_INVALID | CSR_INV_VALIDATOR;
82
83 if (cdef->validator)
84 {
85 rc = cdef->validator(cdef, (intptr_t) value, err);
86
87 if (CSR_RESULT(rc) != CSR_SUCCESS)
88 return rc | CSR_INV_VALIDATOR;
89 }
90
91 string_destroy(var, cdef);
92
93 const char *str = mutt_str_dup(value);
94 if (!str)
95 rc |= CSR_SUC_EMPTY;
96
97 *(const char **) var = str;
98 }
99 else
100 {
101 if (cdef->type & D_INTERNAL_INITIAL_SET)
102 FREE(&cdef->initial);
103
104 cdef->type |= D_INTERNAL_INITIAL_SET;
105 cdef->initial = (intptr_t) mutt_str_dup(value);
106 }
107
108 return rc;
109}
string_destroy
static void string_destroy(void *var, const struct ConfigDef *cdef)
Destroy a String - Implements ConfigSetType::destroy() -.
Definition: string.c:48
+ Here is the call graph for this function:

◆ expando_string_set()

static int expando_string_set ( void *  var,
struct ConfigDef *  cdef,
const char *  value,
struct Buffer *  err 
)
static

Set an Expando by string - Implements ConfigSetType::string_set() -.

Definition at line 61 of file config_type.c.

63{
64 /* Store empty string list as NULL */
65 if (value && (value[0] == '\0'))
66 value = NULL;
67
68 if (!value && (cdef->type & D_NOT_EMPTY))
69 {
70 buf_printf(err, _("Option %s may not be empty"), cdef->name);
71 return CSR_ERR_INVALID | CSR_INV_VALIDATOR;
72 }
73
74 int rc = CSR_SUCCESS;
75
76 if (var)
77 {
78 const struct ExpandoDefinition *defs = (const struct ExpandoDefinition *)
79 cdef->data;
80 struct Expando *exp = expando_parse(value, defs, err);
81 if (!exp && !buf_is_empty(err))
82 {
83 char opt[128] = { 0 };
84 // L10N: e.g. "Option index_format:" plus an error message
85 snprintf(opt, sizeof(opt), _("Option %s: "), cdef->name);
86 buf_insert(err, 0, opt);
87 return CSR_ERR_INVALID;
88 }
89
90 if (expando_equal(exp, *(struct Expando **) var))
91 {
92 expando_free(&exp);
93 return CSR_SUCCESS | CSR_SUC_NO_CHANGE;
94 }
95
96 if (startup_only(cdef, err))
97 {
98 expando_free(&exp);
99 return CSR_ERR_INVALID | CSR_INV_VALIDATOR;
100 }
101
102 if (cdef->validator)
103 {
104 rc = cdef->validator(cdef, (intptr_t) exp, err);
105
106 if (CSR_RESULT(rc) != CSR_SUCCESS)
107 {
108 expando_free(&exp);
109 return rc | CSR_INV_VALIDATOR;
110 }
111 }
112
113 expando_destroy(var, cdef);
114
115 *(struct Expando **) var = exp;
116
117 if (!exp)
118 rc |= CSR_SUC_EMPTY;
119 }
120 else
121 {
122 if (cdef->type & D_INTERNAL_INITIAL_SET)
123 FREE(&cdef->initial);
124
125 cdef->type |= D_INTERNAL_INITIAL_SET;
126 cdef->initial = (intptr_t) mutt_str_dup(value);
127 }
128
129 return rc;
130}
buf_is_empty
bool buf_is_empty(const struct Buffer *buf)
Is the Buffer empty?
Definition: buffer.c:291
buf_insert
size_t buf_insert(struct Buffer *buf, size_t offset, const char *s)
Add a string in the middle of a buffer.
Definition: buffer.c:256
expando_parse
struct Expando * expando_parse(const char *str, const struct ExpandoDefinition *defs, struct Buffer *err)
Parse an Expando string.
Definition: expando.c:81
expando_free
void expando_free(struct Expando **ptr)
Free an Expando object.
Definition: expando.c:61
expando_equal
bool expando_equal(const struct Expando *a, const struct Expando *b)
Compare two expandos.
Definition: expando.c:137
expando_destroy
static void expando_destroy(void *var, const struct ConfigDef *cdef)
Destroy an Expando object - Implements ConfigSetType::destroy() -.
Definition: config_type.c:49
ExpandoDefinition
Definition of a format string.
Definition: definition.h:44
Expando
Parsed Expando trees.
Definition: expando.h:41
+ Here is the call graph for this function: