| Top |
| ENamedParameters * | e_named_parameters_new () |
| ENamedParameters * | e_named_parameters_new_strv () |
| ENamedParameters * | e_named_parameters_new_string () |
| ENamedParameters * | e_named_parameters_new_clone () |
| void | e_named_parameters_free () |
| void | e_named_parameters_clear () |
| void | e_named_parameters_assign () |
| void | e_named_parameters_set () |
| const gchar * | e_named_parameters_get () |
| gchar ** | e_named_parameters_to_strv () |
| gchar * | e_named_parameters_to_string () |
| gboolean | e_named_parameters_test () |
| gboolean | e_named_parameters_exists () |
| guint | e_named_parameters_count () |
| gchar * | e_named_parameters_get_name () |
| gboolean | e_named_parameters_equal () |
The ENamedParameters is a structure, which holds a name~>value pairs. It's usually used to pass credentials between callers.
ENamedParameters *
e_named_parameters_new (void);
Creates a new instance of an ENamedParameters. This should be freed
with e_named_parameters_free(), when no longer needed. Names are
compared case insensitively.
The structure is not thread safe, if the caller requires thread safety, then it should provide it on its own.
Since: 3.8
ENamedParameters *
e_named_parameters_new_strv (const gchar * const *strv);
Creates a new instance of an ENamedParameters, with initial content
being taken from strv
. This should be freed with e_named_parameters_free(),
when no longer needed. Names are compared case insensitively.
The structure is not thread safe, if the caller requires thread safety, then it should provide it on its own.
strv |
NULL-terminated string array to be used as a content of a newly created ENamedParameters |
Since: 3.8
ENamedParameters *
e_named_parameters_new_string (const gchar *str);
Creates a new instance of an ENamedParameters, with initial content being
taken from str
. This should be freed with e_named_parameters_free(),
when no longer needed. Names are compared case insensitively.
The str
should be created with e_named_parameters_to_string(), to be
properly encoded.
The structure is not thread safe, if the caller requires thread safety, then it should provide it on its own.
Since: 3.18
ENamedParameters *
e_named_parameters_new_clone (const ENamedParameters *parameters);
Creates a new instance of an ENamedParameters, with initial content
being taken from parameters
. This should be freed with e_named_parameters_free(),
when no longer needed. Names are compared case insensitively.
The structure is not thread safe, if the caller requires thread safety, then it should provide it on its own.
parameters |
an ENamedParameters to be used as a content of a newly created ENamedParameters |
Since: 3.16
void
e_named_parameters_free (ENamedParameters *parameters);
Frees an instance of ENamedParameters, previously allocated
with e_named_parameters_new(). Function does nothing, if
parameters
is NULL.
Since: 3.8
void
e_named_parameters_clear (ENamedParameters *parameters);
Removes all stored parameters from parameters
.
Since: 3.8
void e_named_parameters_assign (ENamedParameters *parameters,const ENamedParameters *from);
Makes content of the parameters
the same as from
.
Functions clears content of parameters
if from
is NULL.
parameters |
an ENamedParameters to assign values to |
|
from |
an ENamedParameters to get values from, or |
[nullable] |
Since: 3.8
void e_named_parameters_set (ENamedParameters *parameters,const gchar *name,const gchar *value);
Sets parameter named name
to value value
. If value
is NULL,
then the parameter is removed. value
can be an empty string.
Note: There is a restriction on parameter names, it cannot be empty or contain a colon character (':'), otherwise it can be pretty much anything.
parameters |
||
name |
name of a parameter to set |
|
value |
value to set, or |
[nullable] |
Since: 3.8
const gchar * e_named_parameters_get (const ENamedParameters *parameters,const gchar *name);
Returns current value of a parameter with name name
. If not such
exists, then returns NULL.
Since: 3.8
gchar **
e_named_parameters_to_strv (const ENamedParameters *parameters);
Since: 3.8
gchar *
e_named_parameters_to_string (const ENamedParameters *parameters);
Since: 3.18
gboolean e_named_parameters_test (const ENamedParameters *parameters,const gchar *name,const gchar *value,gboolean case_sensitively);
Compares current value of parameter named name
with given value
and returns whether they are equal, either case sensitively or
insensitively, based on case_sensitively
argument. Function
returns FALSE, if no such parameter exists.
parameters |
||
name |
name of a parameter to test |
|
value |
value to test |
|
case_sensitively |
whether to compare case sensitively |
Since: 3.8
gboolean e_named_parameters_exists (const ENamedParameters *parameters,const gchar *name);
Since: 3.18
guint
e_named_parameters_count (const ENamedParameters *parameters);
Since: 3.18
gchar * e_named_parameters_get_name (const ENamedParameters *parameters,gint index);
The name of the parameters at index index
,
or NULL, of the index
is out of bounds or other error. The returned
string should be freed with g_free() when done with it.
[transfer full][nullable]
Since: 3.18
gboolean e_named_parameters_equal (const ENamedParameters *parameters1,const ENamedParameters *parameters2);
Compares the two parameters objects and returns whether they equal.
Note a NULL and empty parameters are also considered equal.
Since: 3.46