xref: /qemu/qobject/qnum.c (revision f917eed3)
1 /*
2  * QNum Module
3  *
4  * Copyright (C) 2009 Red Hat Inc.
5  *
6  * Authors:
7  *  Luiz Capitulino <lcapitulino@redhat.com>
8  *  Anthony Liguori <aliguori@us.ibm.com>
9  *  Marc-André Lureau <marcandre.lureau@redhat.com>
10  *
11  * This work is licensed under the terms of the GNU LGPL, version 2.1 or later.
12  * See the COPYING.LIB file in the top-level directory.
13  */
14 
15 #include "qemu/osdep.h"
16 #include "qapi/qmp/qnum.h"
17 
18 /**
19  * qnum_from_int(): Create a new QNum from an int64_t
20  *
21  * Return strong reference.
22  */
23 QNum *qnum_from_int(int64_t value)
24 {
25     QNum *qn = g_new(QNum, 1);
26 
27     qobject_init(QOBJECT(qn), QTYPE_QNUM);
28     qn->kind = QNUM_I64;
29     qn->u.i64 = value;
30 
31     return qn;
32 }
33 
34 /**
35  * qnum_from_uint(): Create a new QNum from an uint64_t
36  *
37  * Return strong reference.
38  */
39 QNum *qnum_from_uint(uint64_t value)
40 {
41     QNum *qn = g_new(QNum, 1);
42 
43     qobject_init(QOBJECT(qn), QTYPE_QNUM);
44     qn->kind = QNUM_U64;
45     qn->u.u64 = value;
46 
47     return qn;
48 }
49 
50 /**
51  * qnum_from_double(): Create a new QNum from a double
52  *
53  * Return strong reference.
54  */
55 QNum *qnum_from_double(double value)
56 {
57     QNum *qn = g_new(QNum, 1);
58 
59     qobject_init(QOBJECT(qn), QTYPE_QNUM);
60     qn->kind = QNUM_DOUBLE;
61     qn->u.dbl = value;
62 
63     return qn;
64 }
65 
66 /**
67  * qnum_get_try_int(): Get an integer representation of the number
68  *
69  * Return true on success.
70  */
71 bool qnum_get_try_int(const QNum *qn, int64_t *val)
72 {
73     switch (qn->kind) {
74     case QNUM_I64:
75         *val = qn->u.i64;
76         return true;
77     case QNUM_U64:
78         if (qn->u.u64 > INT64_MAX) {
79             return false;
80         }
81         *val = qn->u.u64;
82         return true;
83     case QNUM_DOUBLE:
84         return false;
85     }
86 
87     assert(0);
88     return false;
89 }
90 
91 /**
92  * qnum_get_int(): Get an integer representation of the number
93  *
94  * assert() on failure.
95  */
96 int64_t qnum_get_int(const QNum *qn)
97 {
98     int64_t val;
99     bool success = qnum_get_try_int(qn, &val);
100     assert(success);
101     return val;
102 }
103 
104 /**
105  * qnum_get_uint(): Get an unsigned integer from the number
106  *
107  * Return true on success.
108  */
109 bool qnum_get_try_uint(const QNum *qn, uint64_t *val)
110 {
111     switch (qn->kind) {
112     case QNUM_I64:
113         if (qn->u.i64 < 0) {
114             return false;
115         }
116         *val = qn->u.i64;
117         return true;
118     case QNUM_U64:
119         *val = qn->u.u64;
120         return true;
121     case QNUM_DOUBLE:
122         return false;
123     }
124 
125     assert(0);
126     return false;
127 }
128 
129 /**
130  * qnum_get_uint(): Get an unsigned integer from the number
131  *
132  * assert() on failure.
133  */
134 uint64_t qnum_get_uint(const QNum *qn)
135 {
136     uint64_t val;
137     bool success = qnum_get_try_uint(qn, &val);
138     assert(success);
139     return val;
140 }
141 
142 /**
143  * qnum_get_double(): Get a float representation of the number
144  *
145  * qnum_get_double() loses precision for integers beyond 53 bits.
146  */
147 double qnum_get_double(QNum *qn)
148 {
149     switch (qn->kind) {
150     case QNUM_I64:
151         return qn->u.i64;
152     case QNUM_U64:
153         return qn->u.u64;
154     case QNUM_DOUBLE:
155         return qn->u.dbl;
156     }
157 
158     assert(0);
159     return 0.0;
160 }
161 
162 char *qnum_to_string(QNum *qn)
163 {
164     switch (qn->kind) {
165     case QNUM_I64:
166         return g_strdup_printf("%" PRId64, qn->u.i64);
167     case QNUM_U64:
168         return g_strdup_printf("%" PRIu64, qn->u.u64);
169     case QNUM_DOUBLE:
170         /* FIXME: g_strdup_printf() is locale dependent; but JSON requires
171          * numbers to be formatted as if in the C locale. Dependence
172          * on C locale is a pervasive issue in QEMU. */
173         /* FIXME: This risks printing Inf or NaN, which are not valid
174          * JSON values. */
175         /* 17 digits suffice for IEEE double */
176         return g_strdup_printf("%.17g", qn->u.dbl);
177     }
178 
179     assert(0);
180     return NULL;
181 }
182 
183 /**
184  * qnum_is_equal(): Test whether the two QNums are equal
185  *
186  * Negative integers are never considered equal to unsigned integers,
187  * but positive integers in the range [0, INT64_MAX] are considered
188  * equal independently of whether the QNum's kind is i64 or u64.
189  *
190  * Doubles are never considered equal to integers.
191  */
192 bool qnum_is_equal(const QObject *x, const QObject *y)
193 {
194     QNum *num_x = qobject_to(QNum, x);
195     QNum *num_y = qobject_to(QNum, y);
196 
197     switch (num_x->kind) {
198     case QNUM_I64:
199         switch (num_y->kind) {
200         case QNUM_I64:
201             /* Comparison in native int64_t type */
202             return num_x->u.i64 == num_y->u.i64;
203         case QNUM_U64:
204             /* Implicit conversion of x to uin64_t, so we have to
205              * check its sign before */
206             return num_x->u.i64 >= 0 && num_x->u.i64 == num_y->u.u64;
207         case QNUM_DOUBLE:
208             return false;
209         }
210         abort();
211     case QNUM_U64:
212         switch (num_y->kind) {
213         case QNUM_I64:
214             return qnum_is_equal(y, x);
215         case QNUM_U64:
216             /* Comparison in native uint64_t type */
217             return num_x->u.u64 == num_y->u.u64;
218         case QNUM_DOUBLE:
219             return false;
220         }
221         abort();
222     case QNUM_DOUBLE:
223         switch (num_y->kind) {
224         case QNUM_I64:
225         case QNUM_U64:
226             return false;
227         case QNUM_DOUBLE:
228             /* Comparison in native double type */
229             return num_x->u.dbl == num_y->u.dbl;
230         }
231         abort();
232     }
233 
234     abort();
235 }
236 
237 /**
238  * qnum_destroy_obj(): Free all memory allocated by a
239  * QNum object
240  */
241 void qnum_destroy_obj(QObject *obj)
242 {
243     assert(obj != NULL);
244     g_free(qobject_to(QNum, obj));
245 }
246