| 1 | /* |
| 2 | * QAPI util functions |
| 3 | * |
| 4 | * Copyright Fujitsu, Inc. 2014 |
| 5 | * |
| 6 | * This work is licensed under the terms of the GNU LGPL, version 2.1 or later. |
| 7 | * See the COPYING.LIB file in the top-level directory. |
| 8 | * |
| 9 | */ |
| 10 | |
| 11 | #ifndef QAPI_UTIL_H |
| 12 | #define QAPI_UTIL_H |
| 13 | |
| 14 | typedef enum { |
| 15 | QAPI_DEPRECATED, |
| 16 | QAPI_UNSTABLE, |
| 17 | } QapiSpecialFeature; |
| 18 | |
| 19 | typedef struct QEnumLookup { |
| 20 | const char *const *array; |
| 21 | const uint64_t *const features; |
| 22 | const int size; |
| 23 | } QEnumLookup; |
| 24 | |
| 25 | const char *qapi_enum_lookup(const QEnumLookup *lookup, int val); |
| 26 | int qapi_enum_parse(const QEnumLookup *lookup, const char *buf, |
| 27 | int def, Error **errp); |
| 28 | bool qapi_bool_parse(const char *name, const char *value, bool *obj, |
| 29 | Error **errp); |
| 30 | |
| 31 | int parse_qapi_name(const char *name, bool complete); |
| 32 | |
| 33 | /* |
| 34 | * For any GenericList @list, insert @element at the front. |
| 35 | * |
| 36 | * Note that this macro evaluates @element exactly once, so it is safe |
| 37 | * to have side-effects with that argument. |
| 38 | */ |
| 39 | #define QAPI_LIST_PREPEND(list, element) do { \ |
| 40 | typeof(list) _tmp = g_malloc(sizeof(*(list))); \ |
| 41 | _tmp->value = (element); \ |
| 42 | _tmp->next = (list); \ |
| 43 | (list) = _tmp; \ |
| 44 | } while (0) |
| 45 | |
| 46 | /* |
| 47 | * For any pointer to a GenericList @tail (usually the 'next' member of a |
| 48 | * list element), insert @element at the back and update the tail. |
| 49 | * |
| 50 | * Note that this macro evaluates @element exactly once, so it is safe |
| 51 | * to have side-effects with that argument. |
| 52 | */ |
| 53 | #define QAPI_LIST_APPEND(tail, element) do { \ |
| 54 | *(tail) = g_malloc0(sizeof(**(tail))); \ |
| 55 | (*(tail))->value = (element); \ |
| 56 | (tail) = &(*(tail))->next; \ |
| 57 | } while (0) |
| 58 | |
| 59 | /* |
| 60 | * For any GenericList @list, return its length. |
| 61 | */ |
| 62 | #define QAPI_LIST_LENGTH(list) \ |
| 63 | ({ \ |
| 64 | size_t _len = 0; \ |
| 65 | typeof_strip_qual(list) _tail; \ |
| 66 | for (_tail = list; _tail != NULL; _tail = _tail->next) { \ |
| 67 | _len++; \ |
| 68 | } \ |
| 69 | _len; \ |
| 70 | }) |
| 71 | |
| 72 | #endif |