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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
|
/* SPDX-License-Identifier: GPL-2.0-only */
#ifndef LABWC_ARRAY_H
#define LABWC_ARRAY_H
#include <wayland-server-core.h>
#include "common/mem.h"
/*
* Wayland's wl_array API is a bit sparse consisting only of
* - init
* - release
* - add
* - copy
* - for_each
*
* The purpose of this header is the gather any generic wl_array helpers we
* create.
*
* We take the liberty of using the wl_ suffix here to make it look a bit
* prettier. If Wayland extend the API in future, we will sort the clash then.
*/
/**
* wl_array_len() - return length of wl_array
* @array: wl_array for which to calculate length
* Note: The pointer type might not be 'char' but this is the approach that
* wl_array_for_each() takes, so we align with their style.
*/
static inline size_t
wl_array_len(struct wl_array *array)
{
return array->size / sizeof(const char *);
}
/**
* Iterates in reverse over an array.
* @pos: pointer that each array element will be assigned to
* @array: wl_array to iterate over
*/
#define wl_array_for_each_reverse(pos, array) \
for (pos = !(array)->data ? NULL \
: (void *)((const char *)(array)->data + (array)->size - sizeof(pos)); \
pos && (const char *)pos >= (const char *)(array)->data; \
(pos)--)
/**
* array_add() - add item to wl_array and exit on allocation error
* @_arr: wl_array to add the item to
* @_val: the item to add to the array
*
* Let us illustrate the function of this macro by an example:
*
* uint32_t value = 5;
* array_add(array, value);
*
* ...is the equivalent of the code below which is how you would
* otherwise use the wl_array API:
*
* uint32_t *elm = wl_array_add(array, sizeof(uint32_t));
* if (!elm) {
* perror("failed to allocate memory");
* exit(EXIT_FAILURE);
* }
* *elm = value;
*/
#define array_add(_arr, _val) do { \
__typeof__(_val) *_entry = wl_array_add( \
(_arr), sizeof(__typeof__(_val))); \
die_if_null(_entry); \
*_entry = (_val); \
} while (0)
#endif /* LABWC_ARRAY_H */
|
