Update version for v5.1.0-rc3 release
[qemu.git] / qapi / qapi-util.c
1 /*
2 * QAPI util functions
3 *
4 * Authors:
5 * Hu Tao <hutao@cn.fujitsu.com>
6 * Peter Lieven <pl@kamp.de>
7 *
8 * This work is licensed under the terms of the GNU LGPL, version 2.1 or later.
9 * See the COPYING.LIB file in the top-level directory.
10 *
11 */
12
13 #include "qemu/osdep.h"
14 #include "qapi/error.h"
15 #include "qemu/ctype.h"
16
17 const char *qapi_enum_lookup(const QEnumLookup *lookup, int val)
18 {
19 assert(val >= 0 && val < lookup->size);
20
21 return lookup->array[val];
22 }
23
24 int qapi_enum_parse(const QEnumLookup *lookup, const char *buf,
25 int def, Error **errp)
26 {
27 int i;
28
29 if (!buf) {
30 return def;
31 }
32
33 for (i = 0; i < lookup->size; i++) {
34 if (!strcmp(buf, lookup->array[i])) {
35 return i;
36 }
37 }
38
39 error_setg(errp, "invalid parameter value: %s", buf);
40 return def;
41 }
42
43 /*
44 * Parse a valid QAPI name from @str.
45 * A valid name consists of letters, digits, hyphen and underscore.
46 * It may be prefixed by __RFQDN_ (downstream extension), where RFQDN
47 * may contain only letters, digits, hyphen and period.
48 * The special exception for enumeration names is not implemented.
49 * See docs/devel/qapi-code-gen.txt for more on QAPI naming rules.
50 * Keep this consistent with scripts/qapi.py!
51 * If @complete, the parse fails unless it consumes @str completely.
52 * Return its length on success, -1 on failure.
53 */
54 int parse_qapi_name(const char *str, bool complete)
55 {
56 const char *p = str;
57
58 if (*p == '_') { /* Downstream __RFQDN_ */
59 p++;
60 if (*p != '_') {
61 return -1;
62 }
63 while (*++p) {
64 if (!qemu_isalnum(*p) && *p != '-' && *p != '.') {
65 break;
66 }
67 }
68
69 if (*p != '_') {
70 return -1;
71 }
72 p++;
73 }
74
75 if (!qemu_isalpha(*p)) {
76 return -1;
77 }
78 while (*++p) {
79 if (!qemu_isalnum(*p) && *p != '-' && *p != '_') {
80 break;
81 }
82 }
83
84 if (complete && *p) {
85 return -1;
86 }
87 return p - str;
88 }