1 #ifndef BABELTRACE_VALUES_CONST_H
2 #define BABELTRACE_VALUES_CONST_H
5 * Copyright (c) 2015-2018 Philippe Proulx <pproulx@efficios.com>
7 * Permission is hereby granted, free of charge, to any person obtaining a copy
8 * of this software and associated documentation files (the "Software"), to deal
9 * in the Software without restriction, including without limitation the rights
10 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
11 * copies of the Software, and to permit persons to whom the Software is
12 * furnished to do so, subject to the following conditions:
14 * The above copyright notice and this permission notice shall be included in
15 * all copies or substantial portions of the Software.
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
20 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
22 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
29 /* For bt_bool, bt_value */
30 #include <babeltrace/types.h>
36 enum bt_value_status
{
37 /// Operation canceled.
38 BT_VALUE_STATUS_CANCELED
= 125,
40 /// Cannot allocate memory.
41 BT_VALUE_STATUS_NOMEM
= -12,
44 BT_VALUE_STATUS_OK
= 0,
48 /// Null value object.
49 BT_VALUE_TYPE_NULL
= 0,
51 /// Boolean value object (holds #BT_TRUE or #BT_FALSE).
52 BT_VALUE_TYPE_BOOL
= 1,
54 /// Integer value object (holds a signed 64-bit integer raw value).
55 BT_VALUE_TYPE_INTEGER
= 2,
57 /// Floating point number value object (holds a \c double raw value).
58 BT_VALUE_TYPE_REAL
= 3,
60 /// String value object.
61 BT_VALUE_TYPE_STRING
= 4,
63 /// Array value object.
64 BT_VALUE_TYPE_ARRAY
= 5,
67 BT_VALUE_TYPE_MAP
= 6,
70 extern enum bt_value_type
bt_value_get_type(const bt_value
*object
);
73 bt_bool
bt_value_is_null(const bt_value
*object
)
75 return bt_value_get_type(object
) == BT_VALUE_TYPE_NULL
;
79 bt_bool
bt_value_is_bool(const bt_value
*object
)
81 return bt_value_get_type(object
) == BT_VALUE_TYPE_BOOL
;
85 bt_bool
bt_value_is_integer(const bt_value
*object
)
87 return bt_value_get_type(object
) == BT_VALUE_TYPE_INTEGER
;
91 bt_bool
bt_value_is_real(const bt_value
*object
)
93 return bt_value_get_type(object
) == BT_VALUE_TYPE_REAL
;
97 bt_bool
bt_value_is_string(const bt_value
*object
)
99 return bt_value_get_type(object
) == BT_VALUE_TYPE_STRING
;
103 bt_bool
bt_value_is_array(const bt_value
*object
)
105 return bt_value_get_type(object
) == BT_VALUE_TYPE_ARRAY
;
109 bt_bool
bt_value_is_map(const bt_value
*object
)
111 return bt_value_get_type(object
) == BT_VALUE_TYPE_MAP
;
114 extern enum bt_value_status
bt_value_copy(const bt_value
*object
,
117 extern bt_bool
bt_value_compare(const bt_value
*object_a
,
118 const bt_value
*object_b
);
120 extern bt_bool
bt_value_bool_get(const bt_value
*bool_obj
);
122 extern int64_t bt_value_integer_get(const bt_value
*integer_obj
);
124 extern double bt_value_real_get(const bt_value
*real_obj
);
126 extern const char *bt_value_string_get(const bt_value
*string_obj
);
128 extern uint64_t bt_value_array_get_size(const bt_value
*array_obj
);
131 bt_bool
bt_value_array_is_empty(const bt_value
*array_obj
)
133 return bt_value_array_get_size(array_obj
) == 0;
136 extern const bt_value
*bt_value_array_borrow_element_by_index_const(
137 const bt_value
*array_obj
, uint64_t index
);
139 extern uint64_t bt_value_map_get_size(const bt_value
*map_obj
);
142 bt_bool
bt_value_map_is_empty(const bt_value
*map_obj
)
144 return bt_value_map_get_size(map_obj
) == 0;
147 extern const bt_value
*bt_value_map_borrow_entry_value_const(
148 const bt_value
*map_obj
, const char *key
);
150 typedef bt_bool (* bt_value_map_foreach_entry_const_func
)(const char *key
,
151 const bt_value
*object
, void *data
);
153 extern enum bt_value_status
bt_value_map_foreach_entry_const(
154 const bt_value
*map_obj
,
155 bt_value_map_foreach_entry_const_func func
, void *data
);
157 extern bt_bool
bt_value_map_has_entry(const bt_value
*map_obj
,
160 extern enum bt_value_status
bt_value_map_extend(
161 const bt_value
*base_map_obj
,
162 const bt_value
*extension_map_obj
,
163 bt_value
**extended_map_obj
);
165 extern void bt_value_get_ref(const bt_value
*value
);
167 extern void bt_value_put_ref(const bt_value
*value
);
169 #define BT_VALUE_PUT_REF_AND_RESET(_var) \
171 bt_value_put_ref(_var); \
175 #define BT_VALUE_MOVE_REF(_var_dst, _var_src) \
177 bt_value_put_ref(_var_dst); \
178 (_var_dst) = (_var_src); \
186 #endif /* BABELTRACE_VALUES_CONST_H */