lib: add option field classes with integer selectors
[babeltrace.git] / include / babeltrace2 / trace-ir / field-class-const.h
CommitLineData
924dc299
PP
1#ifndef BABELTRACE2_TRACE_IR_FIELD_CLASS_CONST_H
2#define BABELTRACE2_TRACE_IR_FIELD_CLASS_CONST_H
40f4ba76
PP
3
4/*
bbb7b5f0 5 * Copyright (c) 2010-2019 EfficiOS Inc. and Linux Foundation
40f4ba76 6 *
40f4ba76
PP
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:
13 *
14 * The above copyright notice and this permission notice shall be included in
15 * all copies or substantial portions of the Software.
16 *
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
23 * SOFTWARE.
40f4ba76
PP
24 */
25
4fa90f32
PP
26#ifndef __BT_IN_BABELTRACE_H
27# error "Please include <babeltrace2/babeltrace.h> instead."
28#endif
29
40f4ba76
PP
30#include <stdint.h>
31#include <stddef.h>
32
959b3d46
PP
33#include <babeltrace2/types.h>
34
40f4ba76
PP
35#ifdef __cplusplus
36extern "C" {
37#endif
38
4cdfc5e8 39typedef enum bt_field_class_type {
0aa006b7
PP
40 BT_FIELD_CLASS_TYPE_BOOL = 0,
41 BT_FIELD_CLASS_TYPE_BIT_ARRAY = 1,
42 BT_FIELD_CLASS_TYPE_UNSIGNED_INTEGER = 2,
43 BT_FIELD_CLASS_TYPE_SIGNED_INTEGER = 3,
44 BT_FIELD_CLASS_TYPE_UNSIGNED_ENUMERATION = 4,
45 BT_FIELD_CLASS_TYPE_SIGNED_ENUMERATION = 5,
46 BT_FIELD_CLASS_TYPE_SINGLE_PRECISION_REAL = 6,
47 BT_FIELD_CLASS_TYPE_DOUBLE_PRECISION_REAL = 7,
48 BT_FIELD_CLASS_TYPE_STRING = 8,
49 BT_FIELD_CLASS_TYPE_STRUCTURE = 9,
50 BT_FIELD_CLASS_TYPE_STATIC_ARRAY = 10,
51 BT_FIELD_CLASS_TYPE_DYNAMIC_ARRAY = 11,
52 BT_FIELD_CLASS_TYPE_OPTION_WITHOUT_SELECTOR = 12,
53 BT_FIELD_CLASS_TYPE_OPTION_WITH_BOOL_SELECTOR = 13,
54 BT_FIELD_CLASS_TYPE_OPTION_WITH_UNSIGNED_INTEGER_SELECTOR = 14,
55 BT_FIELD_CLASS_TYPE_OPTION_WITH_SIGNED_INTEGER_SELECTOR = 15,
56 BT_FIELD_CLASS_TYPE_VARIANT_WITHOUT_SELECTOR = 16,
57 BT_FIELD_CLASS_TYPE_VARIANT_WITH_UNSIGNED_SELECTOR = 17,
58 BT_FIELD_CLASS_TYPE_VARIANT_WITH_SIGNED_SELECTOR = 18,
4cdfc5e8 59} bt_field_class_type;
40f4ba76 60
4cdfc5e8 61typedef enum bt_field_class_integer_preferred_display_base {
7b6afccb
PP
62 BT_FIELD_CLASS_INTEGER_PREFERRED_DISPLAY_BASE_BINARY = 2,
63 BT_FIELD_CLASS_INTEGER_PREFERRED_DISPLAY_BASE_OCTAL = 8,
64 BT_FIELD_CLASS_INTEGER_PREFERRED_DISPLAY_BASE_DECIMAL = 10,
65 BT_FIELD_CLASS_INTEGER_PREFERRED_DISPLAY_BASE_HEXADECIMAL = 16,
4cdfc5e8 66} bt_field_class_integer_preferred_display_base;
40f4ba76 67
4cdfc5e8 68extern bt_field_class_type bt_field_class_get_type(
b19ff26f 69 const bt_field_class *field_class);
40f4ba76 70
c6962c96
PP
71extern const bt_value *bt_field_class_borrow_user_attributes_const(
72 const bt_field_class *field_class);
73
1094efa4
PP
74extern uint64_t bt_field_class_bit_array_get_length(
75 const bt_field_class *field_class);
76
40f4ba76 77extern uint64_t bt_field_class_integer_get_field_value_range(
b19ff26f 78 const bt_field_class *field_class);
40f4ba76 79
4cdfc5e8 80extern bt_field_class_integer_preferred_display_base
40f4ba76 81bt_field_class_integer_get_preferred_display_base(
b19ff26f 82 const bt_field_class *field_class);
40f4ba76 83
40f4ba76 84extern uint64_t bt_field_class_enumeration_get_mapping_count(
b19ff26f 85 const bt_field_class *field_class);
40f4ba76 86
9c08c816
PP
87extern const bt_field_class_enumeration_unsigned_mapping *
88bt_field_class_enumeration_unsigned_borrow_mapping_by_index_const(
8f3ccfbc
PP
89 const bt_field_class *field_class, uint64_t index);
90
9c08c816
PP
91extern const bt_field_class_enumeration_unsigned_mapping *
92bt_field_class_enumeration_unsigned_borrow_mapping_by_label_const(
45c51519
PP
93 const bt_field_class *field_class, const char *label);
94
9c08c816
PP
95extern const bt_field_class_enumeration_signed_mapping *
96bt_field_class_enumeration_signed_borrow_mapping_by_index_const(
8f3ccfbc
PP
97 const bt_field_class *field_class, uint64_t index);
98
9c08c816
PP
99extern const bt_field_class_enumeration_signed_mapping *
100bt_field_class_enumeration_signed_borrow_mapping_by_label_const(
45c51519
PP
101 const bt_field_class *field_class, const char *label);
102
8f3ccfbc
PP
103static inline
104const bt_field_class_enumeration_mapping *
9c08c816
PP
105bt_field_class_enumeration_unsigned_mapping_as_mapping_const(
106 const bt_field_class_enumeration_unsigned_mapping *mapping)
8f3ccfbc 107{
005f1204 108 return __BT_UPCAST_CONST(bt_field_class_enumeration_mapping, mapping);
8f3ccfbc 109}
40f4ba76 110
8f3ccfbc
PP
111static inline
112const bt_field_class_enumeration_mapping *
9c08c816
PP
113bt_field_class_enumeration_signed_mapping_as_mapping_const(
114 const bt_field_class_enumeration_signed_mapping *mapping)
8f3ccfbc 115{
005f1204 116 return __BT_UPCAST_CONST(bt_field_class_enumeration_mapping, mapping);
8f3ccfbc 117}
40f4ba76 118
8f3ccfbc
PP
119extern const char *bt_field_class_enumeration_mapping_get_label(
120 const bt_field_class_enumeration_mapping *mapping);
40f4ba76 121
45c51519 122extern const bt_integer_range_set_unsigned *
9c08c816
PP
123bt_field_class_enumeration_unsigned_mapping_borrow_ranges_const(
124 const bt_field_class_enumeration_unsigned_mapping *mapping);
40f4ba76 125
45c51519 126extern const bt_integer_range_set_signed *
9c08c816
PP
127bt_field_class_enumeration_signed_mapping_borrow_ranges_const(
128 const bt_field_class_enumeration_signed_mapping *mapping);
40f4ba76 129
185ecf64 130typedef enum bt_field_class_enumeration_get_mapping_labels_for_value_status {
d24d5663
PP
131 BT_FIELD_CLASS_ENUMERATION_GET_MAPPING_LABELS_BY_VALUE_STATUS_MEMORY_ERROR = __BT_FUNC_STATUS_MEMORY_ERROR,
132 BT_FIELD_CLASS_ENUMERATION_GET_MAPPING_LABELS_BY_VALUE_STATUS_OK = __BT_FUNC_STATUS_OK,
185ecf64 133} bt_field_class_enumeration_get_mapping_labels_for_value_status;
d24d5663 134
185ecf64 135extern bt_field_class_enumeration_get_mapping_labels_for_value_status
9c08c816 136bt_field_class_enumeration_unsigned_get_mapping_labels_for_value(
b19ff26f 137 const bt_field_class *field_class, uint64_t value,
40f4ba76
PP
138 bt_field_class_enumeration_mapping_label_array *label_array,
139 uint64_t *count);
140
185ecf64 141extern bt_field_class_enumeration_get_mapping_labels_for_value_status
9c08c816 142bt_field_class_enumeration_signed_get_mapping_labels_for_value(
b19ff26f 143 const bt_field_class *field_class, int64_t value,
40f4ba76
PP
144 bt_field_class_enumeration_mapping_label_array *label_array,
145 uint64_t *count);
146
147extern uint64_t bt_field_class_structure_get_member_count(
b19ff26f 148 const bt_field_class *field_class);
40f4ba76 149
1e6fd1d7
PP
150extern const bt_field_class_structure_member *
151bt_field_class_structure_borrow_member_by_index_const(
152 const bt_field_class *field_class, uint64_t index);
40f4ba76 153
1e6fd1d7
PP
154extern const bt_field_class_structure_member *
155bt_field_class_structure_borrow_member_by_name_const(
b19ff26f 156 const bt_field_class *field_class, const char *name);
40f4ba76 157
1e6fd1d7
PP
158extern const char *bt_field_class_structure_member_get_name(
159 const bt_field_class_structure_member *member);
160
161extern const bt_field_class *
162bt_field_class_structure_member_borrow_field_class_const(
163 const bt_field_class_structure_member *member);
164
c6962c96
PP
165extern const bt_value *bt_field_class_structure_member_borrow_user_attributes_const(
166 const bt_field_class_structure_member *member);
167
b19ff26f 168extern const bt_field_class *
40f4ba76 169bt_field_class_array_borrow_element_field_class_const(
b19ff26f 170 const bt_field_class *field_class);
40f4ba76 171
9c08c816 172extern uint64_t bt_field_class_array_static_get_length(
b19ff26f 173 const bt_field_class *field_class);
40f4ba76 174
b19ff26f 175extern const bt_field_path *
9c08c816 176bt_field_class_array_dynamic_borrow_length_field_path_const(
b19ff26f 177 const bt_field_class *field_class);
40f4ba76 178
b38aea74
PP
179extern const bt_field_class *
180bt_field_class_option_borrow_field_class_const(
181 const bt_field_class *field_class);
182
183extern const bt_field_path *
0aa006b7
PP
184bt_field_class_option_with_selector_borrow_selector_field_path_const(
185 const bt_field_class *field_class);
186
187extern bt_bool
188bt_field_class_option_with_selector_bool_selector_is_reversed(
189 const bt_field_class *field_class);
190
191extern const bt_integer_range_set_unsigned *
192bt_field_class_option_with_selector_integer_unsigned_borrow_selector_ranges_const(
193 const bt_field_class *field_class);
194
195extern const bt_integer_range_set_signed *
196bt_field_class_option_with_selector_integer_signed_borrow_selector_ranges_const(
b38aea74
PP
197 const bt_field_class *field_class);
198
40f4ba76 199extern uint64_t bt_field_class_variant_get_option_count(
b19ff26f 200 const bt_field_class *field_class);
40f4ba76 201
1e6fd1d7
PP
202extern const bt_field_class_variant_option *
203bt_field_class_variant_borrow_option_by_index_const(
204 const bt_field_class *field_class, uint64_t index);
40f4ba76 205
1e6fd1d7
PP
206extern const bt_field_class_variant_option *
207bt_field_class_variant_borrow_option_by_name_const(
208 const bt_field_class *field_class, const char *name);
209
9c08c816
PP
210extern const bt_field_class_variant_with_selector_unsigned_option *
211bt_field_class_variant_with_selector_unsigned_borrow_option_by_index_const(
45c51519
PP
212 const bt_field_class *field_class, uint64_t index);
213
9c08c816
PP
214extern const bt_field_class_variant_with_selector_unsigned_option *
215bt_field_class_variant_with_selector_unsigned_borrow_option_by_name_const(
45c51519
PP
216 const bt_field_class *field_class, const char *name);
217
9c08c816
PP
218extern const bt_field_class_variant_with_selector_signed_option *
219bt_field_class_variant_with_selector_signed_borrow_option_by_index_const(
45c51519
PP
220 const bt_field_class *field_class, uint64_t index);
221
9c08c816
PP
222extern const bt_field_class_variant_with_selector_signed_option *
223bt_field_class_variant_with_selector_signed_borrow_option_by_name_const(
45c51519
PP
224 const bt_field_class *field_class, const char *name);
225
1e6fd1d7
PP
226extern const char *bt_field_class_variant_option_get_name(
227 const bt_field_class_variant_option *option);
228
229extern const bt_field_class *
230bt_field_class_variant_option_borrow_field_class_const(
231 const bt_field_class_variant_option *option);
40f4ba76 232
c6962c96
PP
233extern const bt_value *bt_field_class_variant_option_borrow_user_attributes_const(
234 const bt_field_class_variant_option *option);
235
45c51519
PP
236extern const bt_field_path *
237bt_field_class_variant_with_selector_borrow_selector_field_path_const(
238 const bt_field_class *field_class);
239
240extern const bt_integer_range_set_unsigned *
9c08c816
PP
241bt_field_class_variant_with_selector_unsigned_option_borrow_ranges_const(
242 const bt_field_class_variant_with_selector_unsigned_option *option);
45c51519
PP
243
244static inline
245const bt_field_class_variant_option *
9c08c816
PP
246bt_field_class_variant_with_selector_unsigned_option_as_option_const(
247 const bt_field_class_variant_with_selector_unsigned_option *option)
45c51519
PP
248{
249 return __BT_UPCAST_CONST(bt_field_class_variant_option, option);
250}
251
252extern const bt_integer_range_set_signed *
9c08c816
PP
253bt_field_class_variant_with_selector_signed_option_borrow_ranges_const(
254 const bt_field_class_variant_with_selector_signed_option *option);
45c51519
PP
255
256static inline
257const bt_field_class_variant_option *
9c08c816
PP
258bt_field_class_variant_with_selector_signed_option_as_option_const(
259 const bt_field_class_variant_with_selector_signed_option *option)
45c51519
PP
260{
261 return __BT_UPCAST_CONST(bt_field_class_variant_option, option);
262}
263
b19ff26f 264extern void bt_field_class_get_ref(const bt_field_class *field_class);
c5b9b441 265
b19ff26f 266extern void bt_field_class_put_ref(const bt_field_class *field_class);
c5b9b441
PP
267
268#define BT_FIELD_CLASS_PUT_REF_AND_RESET(_var) \
269 do { \
270 bt_field_class_put_ref(_var); \
271 (_var) = NULL; \
272 } while (0)
273
274#define BT_FIELD_CLASS_MOVE_REF(_var_dst, _var_src) \
275 do { \
276 bt_field_class_put_ref(_var_dst); \
277 (_var_dst) = (_var_src); \
278 (_var_src) = NULL; \
279 } while (0)
280
281
40f4ba76
PP
282#ifdef __cplusplus
283}
284#endif
285
924dc299 286#endif /* BABELTRACE2_TRACE_IR_FIELD_CLASS_CONST_H */
This page took 0.053062 seconds and 4 git commands to generate.