waffle_attrib_list - Man Page

Utilities for attribute lists

Synopsis

#include <waffle.h>

DEPRECATED bool waffle_attrib_list_length(const int32_t attrib_list[]);

DEPRECATED bool waffle_attrib_list_get(const int32_t attrib_list[], int32_t key, int32_t *value);

DEPRECATED bool waffle_attrib_list_get_with_default(const int32_t attrib_list[], int32_t key, int32_t *value, int32_t default_value);

DEPRECATED bool waffle_attrib_list_update(int32_t attrib_list[], int32_t key, int32_t *value);

Deprecation

All functions above are deprecated in Waffle 1.6 and later.

Description

An attribute list is a zero-terminated list of int32_t key/value pairs or a null pointer. A null pointer is interpreted as an empty list, whose only member is the terminal zero. For concrete examples of attribute lists, see the "Examples" section in waffle_config(3).

All attribute list functions can be called before waffle has been successfully initialized with waffle_init(3).

waffle_attrib_list_length()

Return the number of key/value pairs in the list.

waffle_attrib_list_get()

Get the value associated with key. If the list does not contain the key, then value is not dereferenced. Return true if and only if the list contains the key.

waffle_attrib_list_get_with_default()

Equivalent to waffle_attrib_list_get() except that if the list does not contain the key then value is set to a default_value.

waffle_attrib_list_update()

Update the value associated with key. If the list does not contain the key then the list is not modified. Return true if and only if the list contains the key.

Errors

All attribute list functions set the error code to WAFFLE_NO_ERROR and can be called before waffle has been successfully initialized with waffle_init(3).

See waffle_error(3) for the complete list of waffle's error codes.

Issues

Please report bugs or and feature requests to https://gitlab.freedesktop.org/mesa/waffle/issues.

See Also

waffle(7)

Author

Chad Versace <chad.versace@linux.intel.com>

Maintainer

Referenced By

waffle(7).

The man pages waffle_attrib_list_get(3), waffle_attrib_list_get_with_default(3), waffle_attrib_list_length(3) and waffle_attrib_list_update(3) are aliases of waffle_attrib_list(3).

07/20/2024 Waffle Manual