1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
|
libpkgconf `tuple` module
=========================
The `tuple` module provides key-value mappings backed by a linked list. The key-value
mapping is mainly used for variable substitution when parsing .pc files.
There are two sets of mappings: a ``pkgconf_pkg_t`` specific mapping, and a `global` mapping.
The `tuple` module provides convenience wrappers for managing the `global` mapping, which is
attached to a given client object.
.. c:function:: void pkgconf_tuple_add_global(pkgconf_client_t *client, const char *key, const char *value)
Defines a global variable, replacing the previous declaration if one was set.
:param pkgconf_client_t* client: The pkgconf client object to modify.
:param char* key: The key for the mapping (variable name).
:param char* value: The value for the mapped entry.
:return: nothing
.. c:function:: void pkgconf_tuple_find_global(const pkgconf_client_t *client, const char *key)
Looks up a global variable.
:param pkgconf_client_t* client: The pkgconf client object to access.
:param char* key: The key or variable name to look up.
:return: the contents of the variable or ``NULL``
:rtype: char *
.. c:function:: void pkgconf_tuple_free_global(pkgconf_client_t *client)
Delete all global variables associated with a pkgconf client object.
:param pkgconf_client_t* client: The pkgconf client object to modify.
:return: nothing
.. c:function:: void pkgconf_tuple_define_global(pkgconf_client_t *client, const char *kv)
Parse and define a global variable.
:param pkgconf_client_t* client: The pkgconf client object to modify.
:param char* kv: The variable in the form of ``key=value``.
:return: nothing
.. c:function:: void pkgconf_tuple_free_entry(pkgconf_tuple_t *tuple, pkgconf_list_t *list)
Deletes a variable object, removing it from any variable lists and releasing any memory associated
with it.
:param pkgconf_tuple_t* tuple: The variable object to release.
:param pkgconf_list_t* list: The variable list the variable object is attached to.
:return: nothing
.. c:function:: void pkgconf_tuple_free(pkgconf_list_t *list)
Deletes a variable list and any variables attached to it.
:param pkgconf_list_t* list: The variable list to delete.
:return: nothing
|
