1WAFFLE_ATTRIB_LIST(3)            Waffle Manual           WAFFLE_ATTRIB_LIST(3)
2
3
4

NAME

6       waffle_attrib_list, waffle_attrib_list_length, waffle_attrib_list_get,
7       waffle_attrib_list_get_with_default, waffle_attrib_list_update -
8       Utilities for attribute lists
9

SYNOPSIS

11       #include <waffle.h>
12
13       bool waffle_attrib_list_length(const int32_t attrib_list[]);
14
15       bool waffle_attrib_list_get(const int32_t attrib_list[], int32_t key,
16                                   int32_t *value);
17
18       bool waffle_attrib_list_get_with_default(const int32_t attrib_list[],
19                                                int32_t key, int32_t *value,
20                                                int32_t default_value);
21
22       bool waffle_attrib_list_update(int32_t attrib_list[], int32_t key,
23                                      int32_t *value);
24

DESCRIPTION

26       An attribute list is a zero-terminated list of int32_t key/value pairs
27       or a null pointer. A null pointer is interpreted as an empty list,
28       whose only member is the terminal zero. For concrete examples of
29       attribute lists, see the "Examples" section in waffle_config(3).
30
31       All attribute list functions can be called before waffle has been
32       successfully initialized with waffle_init(3).
33
34       waffle_attrib_list_length()
35           Return the number of key/value pairs in the list.
36
37       waffle_attrib_list_get()
38           Get the value associated with key. If the list does not contain the
39           key, then value is not dereferenced. Return true if and only if the
40           list contains the key.
41
42       waffle_attrib_list_get_with_default()
43           Equivalent to waffle_attrib_list_get() except that if the list does
44           not contain the key then value is set to a default_value.
45
46       waffle_attrib_list_update()
47           Update the value associated with key. If the list does not contain
48           the key then the list is not modified. Return true if and only if
49           the list contains the key.
50

ERRORS

52       All attribute list functions set the error code to WAFFLE_NO_ERROR and
53       can be called before waffle has been successfully initialized with
54       waffle_init(3).
55
56       See waffle_error(3) for the complete list of waffle's error codes.
57

ISSUES

59       Please report bugs or and feature requests to
60       https://github.com/waffle-gl/waffle/issues.
61

SEE ALSO

63       waffle(7)
64

AUTHOR

66       Chad Versace <chad.versace@linux.intel.com>
67           Maintainer
68
70       Copyright © 2013 Intel
71
72       This manual page is licensed under the Creative Commons
73       Attribution-ShareAlike 3.0 United States License (CC BY-SA 3.0). To
74       view a copy of this license, visit
75       http://creativecommons.org.license/by-sa/3.0/us.
76
77
78
79
80waffle                            02/03/2019             WAFFLE_ATTRIB_LIST(3)
Impressum