2 * Copyright (c) 2020 Philippe Proulx <pproulx@efficios.com>
4 * SPDX-License-Identifier: MIT
7 #ifndef BABELTRACE_CPP_COMMON_BT2_FIELD_CLASS_HPP
8 #define BABELTRACE_CPP_COMMON_BT2_FIELD_CLASS_HPP
11 #include <type_traits>
13 #include <babeltrace2/babeltrace.h>
15 #include "common/assert.h"
16 #include "cpp-common/optional.hpp"
17 #include "cpp-common/string_view.hpp"
19 #include "borrowed-object.hpp"
20 #include "common-iterator.hpp"
22 #include "field-path.hpp"
23 #include "integer-range-set.hpp"
24 #include "internal/utils.hpp"
25 #include "shared-object.hpp"
31 struct FieldClassRefFuncs final
33 static void get(const bt_field_class * const libObjPtr) noexcept
35 bt_field_class_get_ref(libObjPtr);
38 static void put(const bt_field_class * const libObjPtr) noexcept
40 bt_field_class_put_ref(libObjPtr);
44 template <typename LibObjT>
45 struct CommonFieldClassSpec;
47 /* Functions specific to mutable field classes */
49 struct CommonFieldClassSpec<bt_field_class> final
51 static bt_value *userAttributes(bt_field_class * const libObjPtr) noexcept
53 return bt_field_class_borrow_user_attributes(libObjPtr);
57 /* Functions specific to constant field classes */
59 struct CommonFieldClassSpec<const bt_field_class> final
61 static const bt_value *userAttributes(const bt_field_class * const libObjPtr) noexcept
63 return bt_field_class_borrow_user_attributes_const(libObjPtr);
67 } /* namespace internal */
69 template <typename ObjT, typename LibObjT>
70 using SharedFieldClass = SharedObject<ObjT, LibObjT, internal::FieldClassRefFuncs>;
72 template <typename LibObjT>
73 class CommonBitArrayFieldClass;
75 template <typename LibObjT>
76 class CommonIntegerFieldClass;
78 template <typename LibObjT>
79 class ConstEnumerationFieldClassMapping;
81 template <typename LibObjT>
82 class CommonBaseEnumerationFieldClass;
84 template <typename LibObjT, typename MappingT>
85 class CommonEnumerationFieldClass;
87 template <typename LibObjT>
88 class CommonStructureFieldClass;
90 template <typename LibObjT>
91 class CommonArrayFieldClass;
93 template <typename LibObjT>
94 class CommonStaticArrayFieldClass;
96 template <typename LibObjT>
97 class CommonDynamicArrayWithLengthFieldClass;
99 template <typename LibObjT>
100 class CommonOptionFieldClass;
102 template <typename LibObjT>
103 class CommonOptionWithSelectorFieldClass;
105 template <typename LibObjT>
106 class CommonOptionWithBoolSelectorFieldClass;
108 template <typename LibObjT>
109 class CommonVariantFieldClass;
111 template <typename LibObjT, typename RangeSetT>
112 class CommonOptionWithIntegerSelectorFieldClass;
114 template <typename LibObjT>
115 class CommonVariantWithoutSelectorFieldClass;
117 template <typename LibObjT>
118 class CommonVariantWithSelectorFieldClass;
120 template <typename LibObjT>
121 class ConstVariantWithIntegerSelectorFieldClassOption;
123 template <typename LibObjT, typename RangeSetT>
124 class CommonVariantWithIntegerSelectorFieldClass;
126 template <typename LibObjT>
127 class CommonEventClass;
129 template <typename LibObjT>
130 class CommonStreamClass;
132 template <typename LibObjT>
133 class CommonTraceClass;
135 enum class FieldClassType
137 BOOL = BT_FIELD_CLASS_TYPE_BOOL,
138 BIT_ARRAY = BT_FIELD_CLASS_TYPE_BIT_ARRAY,
139 UNSIGNED_INTEGER = BT_FIELD_CLASS_TYPE_UNSIGNED_INTEGER,
140 SIGNED_INTEGER = BT_FIELD_CLASS_TYPE_SIGNED_INTEGER,
141 UNSIGNED_ENUMERATION = BT_FIELD_CLASS_TYPE_UNSIGNED_ENUMERATION,
142 SIGNED_ENUMERATION = BT_FIELD_CLASS_TYPE_SIGNED_ENUMERATION,
143 SINGLE_PRECISION_REAL = BT_FIELD_CLASS_TYPE_SINGLE_PRECISION_REAL,
144 DOUBLE_PRECISION_REAL = BT_FIELD_CLASS_TYPE_DOUBLE_PRECISION_REAL,
145 STRING = BT_FIELD_CLASS_TYPE_STRING,
146 STRUCTURE = BT_FIELD_CLASS_TYPE_STRUCTURE,
147 STATIC_ARRAY = BT_FIELD_CLASS_TYPE_STATIC_ARRAY,
148 DYNAMIC_ARRAY_WITHOUT_LENGTH = BT_FIELD_CLASS_TYPE_DYNAMIC_ARRAY_WITHOUT_LENGTH_FIELD,
149 DYNAMIC_ARRAY_WITH_LENGTH = BT_FIELD_CLASS_TYPE_DYNAMIC_ARRAY_WITH_LENGTH_FIELD,
150 OPTION_WITHOUT_SELECTOR = BT_FIELD_CLASS_TYPE_OPTION_WITHOUT_SELECTOR_FIELD,
151 OPTION_WITH_BOOL_SELECTOR = BT_FIELD_CLASS_TYPE_OPTION_WITH_BOOL_SELECTOR_FIELD,
152 OPTION_WITH_UNSIGNED_INTEGER_SELECTOR =
153 BT_FIELD_CLASS_TYPE_OPTION_WITH_UNSIGNED_INTEGER_SELECTOR_FIELD,
154 OPTION_WITH_SIGNED_INTEGER_SELECTOR =
155 BT_FIELD_CLASS_TYPE_OPTION_WITH_SIGNED_INTEGER_SELECTOR_FIELD,
156 VARIANT_WITHOUT_SELECTOR = BT_FIELD_CLASS_TYPE_VARIANT_WITHOUT_SELECTOR_FIELD,
157 VARIANT_WITH_UNSIGNED_INTEGER_SELECTOR =
158 BT_FIELD_CLASS_TYPE_VARIANT_WITH_UNSIGNED_INTEGER_SELECTOR_FIELD,
159 VARIANT_WITH_SIGNED_INTEGER_SELECTOR =
160 BT_FIELD_CLASS_TYPE_VARIANT_WITH_SIGNED_INTEGER_SELECTOR_FIELD,
163 template <typename LibObjT>
164 class CommonFieldClass : public BorrowedObject<LibObjT>
166 /* Allow appendMember() to call `fc.libObjPtr()` */
167 friend class CommonStructureFieldClass<bt_field_class>;
169 /* Allow appendOption() to call `fc.libObjPtr()` */
170 friend class CommonVariantWithoutSelectorFieldClass<bt_field_class>;
172 friend class CommonVariantWithIntegerSelectorFieldClass<
174 ConstVariantWithIntegerSelectorFieldClassOption<
175 const bt_field_class_variant_with_selector_field_integer_unsigned_option>>;
177 friend class CommonVariantWithIntegerSelectorFieldClass<
179 ConstVariantWithIntegerSelectorFieldClassOption<
180 const bt_field_class_variant_with_selector_field_integer_signed_option>>;
182 /* Allow *FieldClass() to call `fc.libObjPtr()` */
183 friend class CommonEventClass<bt_event_class>;
184 friend class CommonStreamClass<bt_stream_class>;
186 /* Allow create*FieldClass() to call `fc.libObjPtr()` */
187 friend class CommonTraceClass<bt_trace_class>;
190 using typename BorrowedObject<LibObjT>::_ThisBorrowedObject;
193 using typename BorrowedObject<LibObjT>::_LibObjPtr;
194 using _ThisCommonFieldClass = CommonFieldClass<LibObjT>;
197 using Shared = SharedFieldClass<CommonFieldClass<LibObjT>, LibObjT>;
199 using UserAttributes =
200 typename std::conditional<std::is_const<LibObjT>::value, ConstMapValue, MapValue>::type;
202 explicit CommonFieldClass(const _LibObjPtr libObjPtr) noexcept : _ThisBorrowedObject {libObjPtr}
206 template <typename OtherLibObjT>
207 CommonFieldClass(const CommonFieldClass<OtherLibObjT> fc) noexcept : _ThisBorrowedObject {fc}
211 template <typename OtherLibObjT>
212 CommonFieldClass& operator=(const CommonFieldClass<OtherLibObjT> fc) noexcept
214 _ThisBorrowedObject::operator=(fc);
218 FieldClassType type() const noexcept
220 return static_cast<FieldClassType>(bt_field_class_get_type(this->libObjPtr()));
223 bool isBool() const noexcept
225 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_BOOL);
228 bool isBitArray() const noexcept
230 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_BIT_ARRAY);
233 bool isInteger() const noexcept
235 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_INTEGER);
238 bool isUnsignedInteger() const noexcept
240 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_UNSIGNED_INTEGER);
243 bool isSignedInteger() const noexcept
245 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_SIGNED_INTEGER);
248 bool isEnumeration() const noexcept
250 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_ENUMERATION);
253 bool isUnsignedEnumeration() const noexcept
255 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_UNSIGNED_ENUMERATION);
258 bool isSignedEnumeration() const noexcept
260 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_SIGNED_ENUMERATION);
263 bool isReal() const noexcept
265 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_REAL);
268 bool isSinglePrecisionReal() const noexcept
270 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_SINGLE_PRECISION_REAL);
273 bool isDoublePrecisionReal() const noexcept
275 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_DOUBLE_PRECISION_REAL);
278 bool isString() const noexcept
280 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_STRING);
283 bool isStructure() const noexcept
285 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_STRUCTURE);
288 bool isArray() const noexcept
290 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_ARRAY);
293 bool isStaticArray() const noexcept
295 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_STATIC_ARRAY);
298 bool isDynamicArray() const noexcept
300 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_DYNAMIC_ARRAY);
303 bool isDynamicArrayWithoutLength() const noexcept
305 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_DYNAMIC_ARRAY_WITHOUT_LENGTH_FIELD);
308 bool isDynamicArrayWithLength() const noexcept
310 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_DYNAMIC_ARRAY_WITH_LENGTH_FIELD);
313 bool isOption() const noexcept
315 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_OPTION);
318 bool isOptionWithoutSelector() const noexcept
320 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_OPTION_WITHOUT_SELECTOR_FIELD);
323 bool isOptionWithSelector() const noexcept
325 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_OPTION_WITH_SELECTOR_FIELD);
328 bool isOptionWithBoolSelector() const noexcept
330 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_OPTION_WITH_BOOL_SELECTOR_FIELD);
333 bool isOptionWithIntegerSelector() const noexcept
335 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_OPTION_WITH_INTEGER_SELECTOR_FIELD);
338 bool isOptionWithUnsignedIntegerSelector() const noexcept
340 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_OPTION_WITH_UNSIGNED_INTEGER_SELECTOR_FIELD);
343 bool isOptionWithSignedIntegerSelector() const noexcept
345 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_OPTION_WITH_SIGNED_INTEGER_SELECTOR_FIELD);
348 bool isVariant() const noexcept
350 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_VARIANT);
353 bool isVariantWithoutSelector() const noexcept
355 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_VARIANT_WITHOUT_SELECTOR_FIELD);
358 bool isVariantWithSelector() const noexcept
360 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_VARIANT_WITH_SELECTOR_FIELD);
363 bool isVariantWithIntegerSelector() const noexcept
365 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_VARIANT_WITH_INTEGER_SELECTOR_FIELD);
368 bool isVariantWithUnsignedIntegerSelector() const noexcept
370 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_VARIANT_WITH_UNSIGNED_INTEGER_SELECTOR_FIELD);
373 bool isVariantWithSignedIntegerSelector() const noexcept
375 return this->_libTypeIs(BT_FIELD_CLASS_TYPE_VARIANT_WITH_SIGNED_INTEGER_SELECTOR_FIELD);
378 template <typename FieldClassT>
379 FieldClassT as() const noexcept
381 return FieldClassT {this->libObjPtr()};
384 CommonBitArrayFieldClass<LibObjT> asBitArray() const noexcept;
385 CommonIntegerFieldClass<LibObjT> asInteger() const noexcept;
386 CommonBaseEnumerationFieldClass<LibObjT> asEnumeration() const noexcept;
387 CommonEnumerationFieldClass<LibObjT, ConstEnumerationFieldClassMapping<
388 const bt_field_class_enumeration_unsigned_mapping>>
389 asUnsignedEnumeration() const noexcept;
391 CommonEnumerationFieldClass<
392 LibObjT, ConstEnumerationFieldClassMapping<const bt_field_class_enumeration_signed_mapping>>
393 asSignedEnumeration() const noexcept;
395 CommonStructureFieldClass<LibObjT> asStructure() const noexcept;
396 CommonArrayFieldClass<LibObjT> asArray() const noexcept;
397 CommonStaticArrayFieldClass<LibObjT> asStaticArray() const noexcept;
398 CommonDynamicArrayWithLengthFieldClass<LibObjT> asDynamicArrayWithLength() const noexcept;
399 CommonOptionFieldClass<LibObjT> asOption() const noexcept;
400 CommonOptionWithSelectorFieldClass<LibObjT> asOptionWithSelector() const noexcept;
401 CommonOptionWithBoolSelectorFieldClass<LibObjT> asOptionWithBoolSelector() const noexcept;
403 CommonOptionWithIntegerSelectorFieldClass<LibObjT, ConstUnsignedIntegerRangeSet>
404 asOptionWithUnsignedIntegerSelector() const noexcept;
406 CommonOptionWithIntegerSelectorFieldClass<LibObjT, ConstSignedIntegerRangeSet>
407 asOptionWithSignedIntegerSelector() const noexcept;
409 CommonVariantFieldClass<LibObjT> asVariant() const noexcept;
410 CommonVariantWithoutSelectorFieldClass<LibObjT> asVariantWithoutSelector() const noexcept;
411 CommonVariantWithSelectorFieldClass<LibObjT> asVariantWithSelector() const noexcept;
413 CommonVariantWithIntegerSelectorFieldClass<
414 LibObjT, ConstVariantWithIntegerSelectorFieldClassOption<
415 const bt_field_class_variant_with_selector_field_integer_unsigned_option>>
416 asVariantWithUnsignedIntegerSelector() const noexcept;
418 CommonVariantWithIntegerSelectorFieldClass<
419 LibObjT, ConstVariantWithIntegerSelectorFieldClassOption<
420 const bt_field_class_variant_with_selector_field_integer_signed_option>>
421 asVariantWithSignedIntegerSelector() const noexcept;
423 template <typename LibValT>
424 void userAttributes(const CommonMapValue<LibValT> userAttrs)
426 static_assert(!std::is_const<LibObjT>::value, "`LibObjT` must NOT be `const`.");
428 bt_field_class_set_user_attributes(this->libObjPtr(), userAttrs.libObjPtr());
431 ConstMapValue userAttributes() const noexcept
433 return ConstMapValue {internal::CommonFieldClassSpec<const bt_field_class>::userAttributes(
437 UserAttributes userAttributes() noexcept
439 return UserAttributes {
440 internal::CommonFieldClassSpec<LibObjT>::userAttributes(this->libObjPtr())};
443 Shared shared() const noexcept
445 return Shared::createWithRef(*this);
449 bool _libTypeIs(const bt_field_class_type type) const noexcept
451 return bt_field_class_type_is(bt_field_class_get_type(this->libObjPtr()), type);
455 using FieldClass = CommonFieldClass<bt_field_class>;
456 using ConstFieldClass = CommonFieldClass<const bt_field_class>;
460 struct FieldClassTypeDescr
462 using Const = ConstFieldClass;
463 using NonConst = FieldClass;
467 struct TypeDescr<FieldClass> : public FieldClassTypeDescr
472 struct TypeDescr<ConstFieldClass> : public FieldClassTypeDescr
476 } /* namespace internal */
478 template <typename LibObjT>
479 class CommonBitArrayFieldClass final : public CommonFieldClass<LibObjT>
482 using typename CommonFieldClass<LibObjT>::_LibObjPtr;
483 using typename CommonFieldClass<LibObjT>::_ThisCommonFieldClass;
486 using Shared = SharedFieldClass<CommonBitArrayFieldClass<LibObjT>, LibObjT>;
488 explicit CommonBitArrayFieldClass(const _LibObjPtr libObjPtr) noexcept :
489 _ThisCommonFieldClass {libObjPtr}
491 BT_ASSERT_DBG(this->isBitArray());
494 template <typename OtherLibObjT>
495 CommonBitArrayFieldClass(const CommonBitArrayFieldClass<OtherLibObjT> fc) noexcept :
496 _ThisCommonFieldClass {fc}
500 template <typename OtherLibObjT>
501 CommonBitArrayFieldClass<LibObjT>&
502 operator=(const CommonBitArrayFieldClass<OtherLibObjT> fc) noexcept
504 _ThisCommonFieldClass::operator=(fc);
508 std::uint64_t length() const noexcept
510 return bt_field_class_bit_array_get_length(this->libObjPtr());
513 Shared shared() const noexcept
515 return Shared::createWithRef(*this);
519 using BitArrayFieldClass = CommonBitArrayFieldClass<bt_field_class>;
520 using ConstBitArrayFieldClass = CommonBitArrayFieldClass<const bt_field_class>;
524 struct BitArrayFieldClassTypeDescr
526 using Const = ConstBitArrayFieldClass;
527 using NonConst = BitArrayFieldClass;
531 struct TypeDescr<BitArrayFieldClass> : public BitArrayFieldClassTypeDescr
536 struct TypeDescr<ConstBitArrayFieldClass> : public BitArrayFieldClassTypeDescr
540 } /* namespace internal */
542 enum class DisplayBase
544 BINARY = BT_FIELD_CLASS_INTEGER_PREFERRED_DISPLAY_BASE_BINARY,
545 OCTAL = BT_FIELD_CLASS_INTEGER_PREFERRED_DISPLAY_BASE_OCTAL,
546 DECIMAL = BT_FIELD_CLASS_INTEGER_PREFERRED_DISPLAY_BASE_DECIMAL,
547 HEXADECIMAL = BT_FIELD_CLASS_INTEGER_PREFERRED_DISPLAY_BASE_HEXADECIMAL,
550 template <typename LibObjT>
551 class CommonIntegerFieldClass : public CommonFieldClass<LibObjT>
554 using typename CommonFieldClass<LibObjT>::_ThisCommonFieldClass;
557 using typename CommonFieldClass<LibObjT>::_LibObjPtr;
558 using _ThisCommonIntegerFieldClass = CommonIntegerFieldClass<LibObjT>;
561 using Shared = SharedFieldClass<CommonIntegerFieldClass<LibObjT>, LibObjT>;
563 explicit CommonIntegerFieldClass(const _LibObjPtr libObjPtr) noexcept :
564 _ThisCommonFieldClass {libObjPtr}
566 BT_ASSERT_DBG(this->isInteger());
569 template <typename OtherLibObjT>
570 CommonIntegerFieldClass(const CommonIntegerFieldClass<OtherLibObjT> fc) noexcept :
571 _ThisCommonFieldClass {fc}
575 template <typename OtherLibObjT>
576 CommonIntegerFieldClass& operator=(const CommonIntegerFieldClass<OtherLibObjT> fc) noexcept
578 _ThisCommonFieldClass::operator=(fc);
582 void fieldValueRange(const std::uint64_t n) noexcept
584 static_assert(!std::is_const<LibObjT>::value, "`LibObjT` must NOT be `const`.");
586 bt_field_class_integer_set_field_value_range(this->libObjPtr(), n);
589 std::uint64_t fieldValueRange() const noexcept
591 return bt_field_class_integer_get_field_value_range(this->libObjPtr());
594 void preferredDisplayBase(const DisplayBase base) noexcept
596 static_assert(!std::is_const<LibObjT>::value, "`LibObjT` must NOT be `const`.");
598 bt_field_class_integer_set_preferred_display_base(
599 this->libObjPtr(), static_cast<bt_field_class_integer_preferred_display_base>(base));
602 DisplayBase preferredDisplayBase() const noexcept
604 return static_cast<DisplayBase>(
605 bt_field_class_integer_get_preferred_display_base(this->libObjPtr()));
608 Shared shared() const noexcept
610 return Shared::createWithRef(*this);
614 using IntegerFieldClass = CommonIntegerFieldClass<bt_field_class>;
615 using ConstIntegerFieldClass = CommonIntegerFieldClass<const bt_field_class>;
619 struct IntegerFieldClassTypeDescr
621 using Const = ConstIntegerFieldClass;
622 using NonConst = IntegerFieldClass;
626 struct TypeDescr<IntegerFieldClass> : public IntegerFieldClassTypeDescr
631 struct TypeDescr<ConstIntegerFieldClass> : public IntegerFieldClassTypeDescr
635 } /* namespace internal */
639 template <typename LibObjT>
640 struct ConstEnumerationFieldClassMappingSpec;
642 /* Functions specific to unsigned enumeration field class mappings */
644 struct ConstEnumerationFieldClassMappingSpec<const bt_field_class_enumeration_unsigned_mapping>
647 static const bt_integer_range_set_unsigned *
648 ranges(const bt_field_class_enumeration_unsigned_mapping * const libObjPtr) noexcept
650 return bt_field_class_enumeration_unsigned_mapping_borrow_ranges_const(libObjPtr);
654 label(const bt_field_class_enumeration_unsigned_mapping * const libObjPtr) noexcept
656 return bt_field_class_enumeration_mapping_get_label(
657 bt_field_class_enumeration_unsigned_mapping_as_mapping_const(libObjPtr));
661 /* Functions specific to signed enumeration field class mappings */
663 struct ConstEnumerationFieldClassMappingSpec<const bt_field_class_enumeration_signed_mapping> final
665 static const bt_integer_range_set_signed *
666 ranges(const bt_field_class_enumeration_signed_mapping * const libObjPtr) noexcept
668 return bt_field_class_enumeration_signed_mapping_borrow_ranges_const(libObjPtr);
672 label(const bt_field_class_enumeration_signed_mapping * const libObjPtr) noexcept
674 return bt_field_class_enumeration_mapping_get_label(
675 bt_field_class_enumeration_signed_mapping_as_mapping_const(libObjPtr));
679 } /* namespace internal */
681 template <typename LibObjT>
682 class ConstEnumerationFieldClassMapping final : public BorrowedObject<LibObjT>
685 using typename BorrowedObject<LibObjT>::_ThisBorrowedObject;
686 using typename BorrowedObject<LibObjT>::_LibObjPtr;
689 using RangeSet = typename std::conditional<
690 std::is_same<LibObjT, const bt_field_class_enumeration_unsigned_mapping>::value,
691 ConstUnsignedIntegerRangeSet, ConstSignedIntegerRangeSet>::type;
693 explicit ConstEnumerationFieldClassMapping(const _LibObjPtr libObjPtr) noexcept :
694 _ThisBorrowedObject {libObjPtr}
698 ConstEnumerationFieldClassMapping(const ConstEnumerationFieldClassMapping& mapping) noexcept :
699 _ThisBorrowedObject {mapping}
703 ConstEnumerationFieldClassMapping&
704 operator=(const ConstEnumerationFieldClassMapping& mapping) noexcept
706 _ThisBorrowedObject::operator=(mapping);
710 RangeSet ranges() const noexcept
713 internal::ConstEnumerationFieldClassMappingSpec<LibObjT>::ranges(this->libObjPtr())};
716 bpstd::string_view label() const noexcept
718 return internal::ConstEnumerationFieldClassMappingSpec<LibObjT>::label(this->libObjPtr());
722 using ConstUnsignedEnumerationFieldClassMapping =
723 ConstEnumerationFieldClassMapping<const bt_field_class_enumeration_unsigned_mapping>;
725 using ConstSignedEnumerationFieldClassMapping =
726 ConstEnumerationFieldClassMapping<const bt_field_class_enumeration_signed_mapping>;
730 template <typename MappingT>
731 struct CommonEnumerationFieldClassSpec;
733 /* Functions specific to unsigned enumeration field classes */
735 struct CommonEnumerationFieldClassSpec<ConstUnsignedEnumerationFieldClassMapping> final
737 static const bt_field_class_enumeration_unsigned_mapping *
738 mappingByIndex(const bt_field_class * const libObjPtr, const std::uint64_t index) noexcept
740 return bt_field_class_enumeration_unsigned_borrow_mapping_by_index_const(libObjPtr, index);
743 static const bt_field_class_enumeration_unsigned_mapping *
744 mappingByLabel(const bt_field_class * const libObjPtr, const char * const label) noexcept
746 return bt_field_class_enumeration_unsigned_borrow_mapping_by_label_const(libObjPtr, label);
749 static bt_field_class_enumeration_add_mapping_status
750 addMapping(bt_field_class * const libObjPtr, const char * const label,
751 const bt_integer_range_set_unsigned * const libRanges) noexcept
753 return bt_field_class_enumeration_unsigned_add_mapping(libObjPtr, label, libRanges);
757 /* Functions specific to signed enumeration field classes */
759 struct CommonEnumerationFieldClassSpec<ConstSignedEnumerationFieldClassMapping> final
761 static const bt_field_class_enumeration_signed_mapping *
762 mappingByIndex(const bt_field_class * const libObjPtr, const std::uint64_t index) noexcept
764 return bt_field_class_enumeration_signed_borrow_mapping_by_index_const(libObjPtr, index);
767 static const bt_field_class_enumeration_signed_mapping *
768 mappingByLabel(const bt_field_class * const libObjPtr, const char * const label) noexcept
770 return bt_field_class_enumeration_signed_borrow_mapping_by_label_const(libObjPtr, label);
773 static bt_field_class_enumeration_add_mapping_status
774 addMapping(bt_field_class * const libObjPtr, const char * const label,
775 const bt_integer_range_set_signed * const libRanges) noexcept
777 return bt_field_class_enumeration_signed_add_mapping(libObjPtr, label, libRanges);
781 } /* namespace internal */
783 template <typename LibObjT>
784 class CommonBaseEnumerationFieldClass : public CommonIntegerFieldClass<LibObjT>
787 using typename CommonIntegerFieldClass<LibObjT>::_ThisCommonIntegerFieldClass;
790 using typename CommonFieldClass<LibObjT>::_LibObjPtr;
791 using _ThisCommonBaseEnumerationFieldClass = CommonBaseEnumerationFieldClass<LibObjT>;
794 using Shared = SharedFieldClass<_ThisCommonBaseEnumerationFieldClass, LibObjT>;
796 explicit CommonBaseEnumerationFieldClass(const _LibObjPtr libObjPtr) noexcept :
797 _ThisCommonIntegerFieldClass {libObjPtr}
799 BT_ASSERT_DBG(this->isEnumeration());
802 template <typename OtherLibObjT>
803 CommonBaseEnumerationFieldClass(const CommonBaseEnumerationFieldClass<OtherLibObjT> fc) noexcept
805 _ThisCommonIntegerFieldClass {fc}
809 template <typename OtherLibObjT>
810 CommonBaseEnumerationFieldClass&
811 operator=(const CommonBaseEnumerationFieldClass<OtherLibObjT> fc) noexcept
813 _ThisCommonIntegerFieldClass::operator=(fc);
817 std::uint64_t size() const noexcept
819 return bt_field_class_enumeration_get_mapping_count(this->libObjPtr());
822 Shared shared() const noexcept
824 return Shared::createWithRef(*this);
828 template <typename LibObjT, typename MappingT>
829 class CommonEnumerationFieldClass final : public CommonBaseEnumerationFieldClass<LibObjT>
832 using typename CommonFieldClass<LibObjT>::_LibObjPtr;
833 using typename CommonBaseEnumerationFieldClass<LibObjT>::_ThisCommonBaseEnumerationFieldClass;
834 using _ThisCommonEnumerationFieldClass = CommonEnumerationFieldClass<LibObjT, MappingT>;
837 using Shared = SharedFieldClass<_ThisCommonEnumerationFieldClass, LibObjT>;
838 using Iterator = CommonIterator<CommonEnumerationFieldClass, MappingT>;
839 using Mapping = MappingT;
841 explicit CommonEnumerationFieldClass(const _LibObjPtr libObjPtr) noexcept :
842 _ThisCommonBaseEnumerationFieldClass {libObjPtr}
844 BT_ASSERT_DBG(this->isEnumeration());
847 template <typename OtherLibObjT>
848 CommonEnumerationFieldClass(
849 const CommonEnumerationFieldClass<OtherLibObjT, MappingT> fc) noexcept :
850 _ThisCommonEnumerationFieldClass {fc}
854 template <typename OtherLibObjT>
855 CommonEnumerationFieldClass&
856 operator=(const CommonEnumerationFieldClass<OtherLibObjT, MappingT> fc) noexcept
858 _ThisCommonEnumerationFieldClass::operator=(fc);
862 Mapping operator[](const std::uint64_t index) const noexcept
864 return Mapping {internal::CommonEnumerationFieldClassSpec<MappingT>::mappingByIndex(
865 this->libObjPtr(), index)};
868 nonstd::optional<Mapping> operator[](const char * const label) const noexcept
870 const auto libObjPtr = internal::CommonEnumerationFieldClassSpec<MappingT>::mappingByLabel(
871 this->libObjPtr(), label);
874 return Mapping {libObjPtr};
877 return nonstd::nullopt;
880 nonstd::optional<Mapping> operator[](const std::string& label) const noexcept
882 return (*this)[label.data()];
885 void addMapping(const char * const label, const typename Mapping::RangeSet ranges)
887 const auto status = internal::CommonEnumerationFieldClassSpec<MappingT>::addMapping(
888 this->libObjPtr(), label, ranges.libObjPtr());
890 if (status == BT_FIELD_CLASS_ENUMERATION_ADD_MAPPING_STATUS_MEMORY_ERROR) {
891 throw MemoryError {};
895 void addMapping(const std::string& label, const typename Mapping::RangeSet ranges)
897 this->addMapping(label.data(), ranges);
900 Iterator begin() const noexcept
902 return Iterator {*this, 0};
905 Iterator end() const noexcept
907 return Iterator {*this, this->size()};
910 Shared shared() const noexcept
912 return Shared::createWithRef(*this);
916 using EnumerationFieldClass = CommonBaseEnumerationFieldClass<bt_field_class>;
917 using ConstEnumerationFieldClass = CommonBaseEnumerationFieldClass<const bt_field_class>;
919 using UnsignedEnumerationFieldClass =
920 CommonEnumerationFieldClass<bt_field_class, ConstUnsignedEnumerationFieldClassMapping>;
922 using ConstUnsignedEnumerationFieldClass =
923 CommonEnumerationFieldClass<const bt_field_class, ConstUnsignedEnumerationFieldClassMapping>;
925 using SignedEnumerationFieldClass =
926 CommonEnumerationFieldClass<bt_field_class, ConstSignedEnumerationFieldClassMapping>;
928 using ConstSignedEnumerationFieldClass =
929 CommonEnumerationFieldClass<const bt_field_class, ConstSignedEnumerationFieldClassMapping>;
933 struct UnsignedEnumerationFieldClassTypeDescr
935 using Const = ConstUnsignedEnumerationFieldClass;
936 using NonConst = UnsignedEnumerationFieldClass;
940 struct TypeDescr<UnsignedEnumerationFieldClass> : public UnsignedEnumerationFieldClassTypeDescr
945 struct TypeDescr<ConstUnsignedEnumerationFieldClass> : public UnsignedEnumerationFieldClassTypeDescr
949 struct SignedEnumerationFieldClassTypeDescr
951 using Const = ConstSignedEnumerationFieldClass;
952 using NonConst = SignedEnumerationFieldClass;
956 struct TypeDescr<SignedEnumerationFieldClass> : public SignedEnumerationFieldClassTypeDescr
961 struct TypeDescr<ConstSignedEnumerationFieldClass> : public SignedEnumerationFieldClassTypeDescr
965 template <typename LibObjT>
966 struct CommonStructureFieldClassMemberSpec;
968 /* Functions specific to mutable structure field class members */
970 struct CommonStructureFieldClassMemberSpec<bt_field_class_structure_member> final
972 static bt_field_class *fieldClass(bt_field_class_structure_member * const libObjPtr) noexcept
974 return bt_field_class_structure_member_borrow_field_class(libObjPtr);
977 static bt_value *userAttributes(bt_field_class_structure_member * const libObjPtr) noexcept
979 return bt_field_class_structure_member_borrow_user_attributes(libObjPtr);
983 /* Functions specific to constant structure field class members */
985 struct CommonStructureFieldClassMemberSpec<const bt_field_class_structure_member> final
987 static const bt_field_class *
988 fieldClass(const bt_field_class_structure_member * const libObjPtr) noexcept
990 return bt_field_class_structure_member_borrow_field_class_const(libObjPtr);
993 static const bt_value *
994 userAttributes(const bt_field_class_structure_member * const libObjPtr) noexcept
996 return bt_field_class_structure_member_borrow_user_attributes_const(libObjPtr);
1000 } /* namespace internal */
1002 template <typename LibObjT>
1003 class CommonStructureFieldClassMember final : public BorrowedObject<LibObjT>
1006 using typename BorrowedObject<LibObjT>::_LibObjPtr;
1007 using typename BorrowedObject<LibObjT>::_ThisBorrowedObject;
1010 typename std::conditional<std::is_const<LibObjT>::value, ConstFieldClass, FieldClass>::type;
1013 using UserAttributes =
1014 typename std::conditional<std::is_const<LibObjT>::value, ConstMapValue, MapValue>::type;
1016 explicit CommonStructureFieldClassMember(const _LibObjPtr libObjPtr) noexcept :
1017 _ThisBorrowedObject {libObjPtr}
1021 template <typename OtherLibObjT>
1022 CommonStructureFieldClassMember(const CommonStructureFieldClassMember<OtherLibObjT> fc) noexcept
1024 _ThisBorrowedObject {fc}
1028 template <typename OtherLibObjT>
1029 CommonStructureFieldClassMember<LibObjT>&
1030 operator=(const CommonStructureFieldClassMember<OtherLibObjT> fc) noexcept
1032 _ThisBorrowedObject::operator=(fc);
1036 bpstd::string_view name() const noexcept
1038 return bt_field_class_structure_member_get_name(this->libObjPtr());
1041 ConstFieldClass fieldClass() const noexcept
1043 return ConstFieldClass {internal::CommonStructureFieldClassMemberSpec<
1044 const bt_field_class_structure_member>::fieldClass(this->libObjPtr())};
1047 _FieldClass fieldClass() noexcept
1049 return _FieldClass {
1050 internal::CommonStructureFieldClassMemberSpec<LibObjT>::fieldClass(this->libObjPtr())};
1053 template <typename LibValT>
1054 void userAttributes(const CommonMapValue<LibValT> userAttrs)
1056 static_assert(!std::is_const<LibObjT>::value, "`LibObjT` must NOT be `const`.");
1058 bt_field_class_structure_member_set_user_attributes(this->libObjPtr(),
1059 userAttrs.libObjPtr());
1062 ConstMapValue userAttributes() const noexcept
1064 return ConstMapValue {internal::CommonStructureFieldClassMemberSpec<
1065 const bt_field_class_structure_member>::userAttributes(this->libObjPtr())};
1068 UserAttributes userAttributes() noexcept
1070 return UserAttributes {
1071 internal::CommonStructureFieldClassMemberSpec<LibObjT>::userAttributes(
1072 this->libObjPtr())};
1076 using StructureFieldClassMember = CommonStructureFieldClassMember<bt_field_class_structure_member>;
1078 using ConstStructureFieldClassMember =
1079 CommonStructureFieldClassMember<const bt_field_class_structure_member>;
1081 namespace internal {
1083 struct StructureFieldClassMemberTypeDescr
1085 using Const = ConstStructureFieldClassMember;
1086 using NonConst = StructureFieldClassMember;
1090 struct TypeDescr<StructureFieldClassMember> : public StructureFieldClassMemberTypeDescr
1095 struct TypeDescr<ConstStructureFieldClassMember> : public StructureFieldClassMemberTypeDescr
1099 template <typename LibObjT>
1100 struct CommonStructureFieldClassSpec;
1102 /* Functions specific to mutable structure field classes */
1104 struct CommonStructureFieldClassSpec<bt_field_class> final
1106 static bt_field_class_structure_member *memberByIndex(bt_field_class * const libObjPtr,
1107 const std::uint64_t index) noexcept
1109 return bt_field_class_structure_borrow_member_by_index(libObjPtr, index);
1112 static bt_field_class_structure_member *memberByName(bt_field_class * const libObjPtr,
1113 const char * const name) noexcept
1115 return bt_field_class_structure_borrow_member_by_name(libObjPtr, name);
1119 /* Functions specific to constant structure field classes */
1121 struct CommonStructureFieldClassSpec<const bt_field_class> final
1123 static const bt_field_class_structure_member *
1124 memberByIndex(const bt_field_class * const libObjPtr, const std::uint64_t index) noexcept
1126 return bt_field_class_structure_borrow_member_by_index_const(libObjPtr, index);
1129 static const bt_field_class_structure_member *
1130 memberByName(const bt_field_class * const libObjPtr, const char * const name) noexcept
1132 return bt_field_class_structure_borrow_member_by_name_const(libObjPtr, name);
1136 } /* namespace internal */
1138 template <typename LibObjT>
1139 class CommonStructureFieldClass final : public CommonFieldClass<LibObjT>
1142 using typename CommonFieldClass<LibObjT>::_LibObjPtr;
1143 using typename CommonFieldClass<LibObjT>::_ThisCommonFieldClass;
1146 using Shared = SharedFieldClass<CommonStructureFieldClass<LibObjT>, LibObjT>;
1148 typename std::conditional<std::is_const<LibObjT>::value, ConstStructureFieldClassMember,
1149 StructureFieldClassMember>::type;
1151 using Iterator = CommonIterator<CommonStructureFieldClass<LibObjT>, Member>;
1153 explicit CommonStructureFieldClass(const _LibObjPtr libObjPtr) noexcept :
1154 _ThisCommonFieldClass {libObjPtr}
1156 BT_ASSERT_DBG(this->isStructure());
1159 template <typename OtherLibObjT>
1160 CommonStructureFieldClass(const CommonStructureFieldClass<OtherLibObjT> fc) noexcept :
1161 _ThisCommonFieldClass {fc}
1165 template <typename OtherLibObjT>
1166 CommonStructureFieldClass& operator=(const CommonStructureFieldClass<OtherLibObjT> fc) noexcept
1168 _ThisCommonFieldClass::operator=(fc);
1172 void appendMember(const char * const name, const FieldClass fc)
1174 static_assert(!std::is_const<LibObjT>::value, "`LibObjT` must NOT be `const`.");
1177 bt_field_class_structure_append_member(this->libObjPtr(), name, fc.libObjPtr());
1179 if (status == BT_FIELD_CLASS_STRUCTURE_APPEND_MEMBER_STATUS_MEMORY_ERROR) {
1180 throw MemoryError {};
1184 void appendMember(const std::string& name, const FieldClass fc)
1186 this->appendMember(name.data(), fc);
1189 std::uint64_t size() const noexcept
1191 return bt_field_class_structure_get_member_count(this->libObjPtr());
1194 Iterator begin() const noexcept
1196 return Iterator {*this, 0};
1199 Iterator end() const noexcept
1201 return Iterator {*this, this->size()};
1204 ConstStructureFieldClassMember operator[](const std::uint64_t index) const noexcept
1206 return ConstStructureFieldClassMember {
1207 internal::CommonStructureFieldClassSpec<const bt_field_class>::memberByIndex(
1208 this->libObjPtr(), index)};
1211 Member operator[](const std::uint64_t index) noexcept
1213 return Member {internal::CommonStructureFieldClassSpec<LibObjT>::memberByIndex(
1214 this->libObjPtr(), index)};
1217 nonstd::optional<ConstStructureFieldClassMember>
1218 operator[](const char * const name) const noexcept
1220 const auto libObjPtr =
1221 internal::CommonStructureFieldClassSpec<const bt_field_class>::memberByName(
1222 this->libObjPtr(), name);
1225 return ConstStructureFieldClassMember {libObjPtr};
1228 return nonstd::nullopt;
1231 nonstd::optional<ConstStructureFieldClassMember>
1232 operator[](const std::string& name) const noexcept
1234 return (*this)[name.data()];
1237 nonstd::optional<Member> operator[](const char * const name) noexcept
1239 const auto libObjPtr =
1240 internal::CommonStructureFieldClassSpec<LibObjT>::memberByName(this->libObjPtr(), name);
1243 return Member {libObjPtr};
1246 return nonstd::nullopt;
1249 nonstd::optional<Member> operator[](const std::string& name) noexcept
1251 return (*this)[name.data()];
1254 Shared shared() const noexcept
1256 return Shared::createWithRef(*this);
1260 using StructureFieldClass = CommonStructureFieldClass<bt_field_class>;
1261 using ConstStructureFieldClass = CommonStructureFieldClass<const bt_field_class>;
1263 namespace internal {
1265 struct StructureFieldClassTypeDescr
1267 using Const = ConstStructureFieldClass;
1268 using NonConst = StructureFieldClass;
1272 struct TypeDescr<StructureFieldClass> : public StructureFieldClassTypeDescr
1277 struct TypeDescr<ConstStructureFieldClass> : public StructureFieldClassTypeDescr
1281 template <typename LibObjT>
1282 struct CommonArrayFieldClassSpec;
1284 /* Functions specific to mutable array field classes */
1286 struct CommonArrayFieldClassSpec<bt_field_class> final
1288 static bt_field_class *elementFieldClass(bt_field_class * const libObjPtr) noexcept
1290 return bt_field_class_array_borrow_element_field_class(libObjPtr);
1294 /* Functions specific to constant array field classes */
1296 struct CommonArrayFieldClassSpec<const bt_field_class> final
1298 static const bt_field_class *elementFieldClass(const bt_field_class * const libObjPtr) noexcept
1300 return bt_field_class_array_borrow_element_field_class_const(libObjPtr);
1304 } /* namespace internal */
1306 template <typename LibObjT>
1307 class CommonArrayFieldClass : public CommonFieldClass<LibObjT>
1310 using typename CommonFieldClass<LibObjT>::_ThisCommonFieldClass;
1313 typename std::conditional<std::is_const<LibObjT>::value, ConstFieldClass, FieldClass>::type;
1316 using typename CommonFieldClass<LibObjT>::_LibObjPtr;
1317 using _ThisCommonArrayFieldClass = CommonArrayFieldClass<LibObjT>;
1320 using Shared = SharedFieldClass<CommonArrayFieldClass<LibObjT>, LibObjT>;
1322 explicit CommonArrayFieldClass(const _LibObjPtr libObjPtr) noexcept :
1323 _ThisCommonFieldClass {libObjPtr}
1325 BT_ASSERT_DBG(this->isArray());
1328 template <typename OtherLibObjT>
1329 CommonArrayFieldClass(const CommonArrayFieldClass<OtherLibObjT> fc) noexcept :
1330 _ThisCommonFieldClass {fc}
1334 template <typename OtherLibObjT>
1335 CommonArrayFieldClass& operator=(const CommonArrayFieldClass<OtherLibObjT> fc) noexcept
1337 _ThisCommonFieldClass::operator=(fc);
1341 ConstFieldClass elementFieldClass() const noexcept
1343 return ConstFieldClass {
1344 internal::CommonArrayFieldClassSpec<const bt_field_class>::elementFieldClass(
1345 this->libObjPtr())};
1348 _FieldClass elementFieldClass() noexcept
1350 return _FieldClass {
1351 internal::CommonArrayFieldClassSpec<LibObjT>::elementFieldClass(this->libObjPtr())};
1354 Shared shared() const noexcept
1356 return Shared::createWithRef(*this);
1360 using ArrayFieldClass = CommonArrayFieldClass<bt_field_class>;
1361 using ConstArrayFieldClass = CommonArrayFieldClass<const bt_field_class>;
1363 namespace internal {
1365 struct ArrayFieldClassTypeDescr
1367 using Const = ConstArrayFieldClass;
1368 using NonConst = ArrayFieldClass;
1372 struct TypeDescr<ArrayFieldClass> : public ArrayFieldClassTypeDescr
1377 struct TypeDescr<ConstArrayFieldClass> : public ArrayFieldClassTypeDescr
1381 } /* namespace internal */
1383 template <typename LibObjT>
1384 class CommonStaticArrayFieldClass final : public CommonArrayFieldClass<LibObjT>
1387 using typename CommonArrayFieldClass<LibObjT>::_ThisCommonArrayFieldClass;
1388 using typename CommonFieldClass<LibObjT>::_LibObjPtr;
1391 using Shared = SharedFieldClass<CommonStaticArrayFieldClass<LibObjT>, LibObjT>;
1393 explicit CommonStaticArrayFieldClass(const _LibObjPtr libObjPtr) noexcept :
1394 _ThisCommonArrayFieldClass {libObjPtr}
1396 BT_ASSERT_DBG(this->isStaticArray());
1399 template <typename OtherLibObjT>
1400 CommonStaticArrayFieldClass(const CommonStaticArrayFieldClass<OtherLibObjT> fc) noexcept :
1401 _ThisCommonArrayFieldClass {fc}
1405 template <typename OtherLibObjT>
1406 CommonStaticArrayFieldClass&
1407 operator=(const CommonStaticArrayFieldClass<OtherLibObjT> fc) noexcept
1409 _ThisCommonArrayFieldClass::operator=(fc);
1413 std::uint64_t length() const noexcept
1415 return bt_field_class_array_static_get_length(this->libObjPtr());
1418 Shared shared() const noexcept
1420 return Shared::createWithRef(*this);
1424 using StaticArrayFieldClass = CommonStaticArrayFieldClass<bt_field_class>;
1425 using ConstStaticArrayFieldClass = CommonStaticArrayFieldClass<const bt_field_class>;
1427 namespace internal {
1429 struct StaticArrayFieldClassTypeDescr
1431 using Const = ConstStaticArrayFieldClass;
1432 using NonConst = StaticArrayFieldClass;
1436 struct TypeDescr<StaticArrayFieldClass> : public StaticArrayFieldClassTypeDescr
1441 struct TypeDescr<ConstStaticArrayFieldClass> : public StaticArrayFieldClassTypeDescr
1445 } /* namespace internal */
1447 template <typename LibObjT>
1448 class CommonDynamicArrayWithLengthFieldClass final : public CommonArrayFieldClass<LibObjT>
1451 using typename CommonArrayFieldClass<LibObjT>::_ThisCommonArrayFieldClass;
1452 using typename CommonFieldClass<LibObjT>::_LibObjPtr;
1455 using Shared = SharedFieldClass<CommonDynamicArrayWithLengthFieldClass<LibObjT>, LibObjT>;
1457 explicit CommonDynamicArrayWithLengthFieldClass(const _LibObjPtr libObjPtr) noexcept :
1458 _ThisCommonArrayFieldClass {libObjPtr}
1460 BT_ASSERT_DBG(this->isDynamicArrayWithLength());
1463 template <typename OtherLibObjT>
1464 CommonDynamicArrayWithLengthFieldClass(
1465 const CommonDynamicArrayWithLengthFieldClass<OtherLibObjT> fc) noexcept :
1466 _ThisCommonArrayFieldClass {fc}
1470 template <typename OtherLibObjT>
1471 CommonDynamicArrayWithLengthFieldClass&
1472 operator=(const CommonDynamicArrayWithLengthFieldClass<OtherLibObjT> fc) noexcept
1474 _ThisCommonArrayFieldClass::operator=(fc);
1478 ConstFieldPath lengthFieldPath() const noexcept
1480 return ConstFieldPath {
1481 bt_field_class_array_dynamic_with_length_field_borrow_length_field_path_const(
1482 this->libObjPtr())};
1485 Shared shared() const noexcept
1487 return Shared::createWithRef(*this);
1491 using DynamicArrayWithLengthFieldClass = CommonDynamicArrayWithLengthFieldClass<bt_field_class>;
1493 using ConstDynamicArrayWithLengthFieldClass =
1494 CommonDynamicArrayWithLengthFieldClass<const bt_field_class>;
1496 namespace internal {
1498 struct DynamicArrayWithLengthFieldClassTypeDescr
1500 using Const = ConstDynamicArrayWithLengthFieldClass;
1501 using NonConst = DynamicArrayWithLengthFieldClass;
1505 struct TypeDescr<DynamicArrayWithLengthFieldClass> :
1506 public DynamicArrayWithLengthFieldClassTypeDescr
1511 struct TypeDescr<ConstDynamicArrayWithLengthFieldClass> :
1512 public DynamicArrayWithLengthFieldClassTypeDescr
1516 template <typename LibObjT>
1517 struct CommonOptionFieldClassSpec;
1519 /* Functions specific to mutable option field classes */
1521 struct CommonOptionFieldClassSpec<bt_field_class> final
1523 static bt_field_class *fieldClass(bt_field_class * const libObjPtr) noexcept
1525 return bt_field_class_option_borrow_field_class(libObjPtr);
1529 /* Functions specific to constant option field classes */
1531 struct CommonOptionFieldClassSpec<const bt_field_class> final
1533 static const bt_field_class *fieldClass(const bt_field_class * const libObjPtr) noexcept
1535 return bt_field_class_option_borrow_field_class_const(libObjPtr);
1539 } /* namespace internal */
1541 template <typename LibObjT>
1542 class CommonOptionFieldClass : public CommonFieldClass<LibObjT>
1545 using typename CommonFieldClass<LibObjT>::_ThisCommonFieldClass;
1548 typename std::conditional<std::is_const<LibObjT>::value, ConstFieldClass, FieldClass>::type;
1551 using typename CommonFieldClass<LibObjT>::_LibObjPtr;
1552 using _ThisCommonOptionFieldClass = CommonOptionFieldClass<LibObjT>;
1555 using Shared = SharedFieldClass<CommonOptionFieldClass<LibObjT>, LibObjT>;
1557 explicit CommonOptionFieldClass(const _LibObjPtr libObjPtr) noexcept :
1558 _ThisCommonFieldClass {libObjPtr}
1560 BT_ASSERT_DBG(this->isOption());
1563 template <typename OtherLibObjT>
1564 CommonOptionFieldClass(const CommonOptionFieldClass<OtherLibObjT> fc) noexcept :
1565 _ThisCommonFieldClass {fc}
1569 template <typename OtherLibObjT>
1570 CommonOptionFieldClass& operator=(const CommonOptionFieldClass<OtherLibObjT> fc) noexcept
1572 _ThisCommonFieldClass::operator=(fc);
1576 ConstFieldClass fieldClass() const noexcept
1578 return ConstFieldClass {
1579 internal::CommonOptionFieldClassSpec<const bt_field_class>::fieldClass(
1580 this->libObjPtr())};
1583 _FieldClass fieldClass() noexcept
1585 return _FieldClass {
1586 internal::CommonOptionFieldClassSpec<LibObjT>::fieldClass(this->libObjPtr())};
1589 Shared shared() const noexcept
1591 return Shared::createWithRef(*this);
1595 using OptionFieldClass = CommonOptionFieldClass<bt_field_class>;
1596 using ConstOptionFieldClass = CommonOptionFieldClass<const bt_field_class>;
1598 namespace internal {
1600 struct OptionFieldClassTypeDescr
1602 using Const = ConstOptionFieldClass;
1603 using NonConst = OptionFieldClass;
1607 struct TypeDescr<OptionFieldClass> : public OptionFieldClassTypeDescr
1612 struct TypeDescr<ConstOptionFieldClass> : public OptionFieldClassTypeDescr
1616 } /* namespace internal */
1618 template <typename LibObjT>
1619 class CommonOptionWithSelectorFieldClass : public CommonOptionFieldClass<LibObjT>
1622 using typename CommonOptionFieldClass<LibObjT>::_ThisCommonOptionFieldClass;
1625 using typename CommonFieldClass<LibObjT>::_LibObjPtr;
1626 using _ThisCommonOptionWithSelectorFieldClass = CommonOptionWithSelectorFieldClass<LibObjT>;
1629 using Shared = SharedFieldClass<CommonOptionWithSelectorFieldClass<LibObjT>, LibObjT>;
1631 explicit CommonOptionWithSelectorFieldClass(const _LibObjPtr libObjPtr) noexcept :
1632 _ThisCommonOptionFieldClass {libObjPtr}
1634 BT_ASSERT_DBG(this->isOptionWithSelector());
1637 template <typename OtherLibObjT>
1638 CommonOptionWithSelectorFieldClass(
1639 const CommonOptionWithSelectorFieldClass<OtherLibObjT> fc) noexcept :
1640 _ThisCommonOptionFieldClass {fc}
1644 template <typename OtherLibObjT>
1645 CommonOptionWithSelectorFieldClass&
1646 operator=(const CommonOptionWithSelectorFieldClass<OtherLibObjT> fc) noexcept
1648 _ThisCommonOptionFieldClass::operator=(fc);
1652 ConstFieldPath selectorFieldPath() const noexcept
1654 return ConstFieldPath {
1655 bt_field_class_option_with_selector_field_borrow_selector_field_path_const(
1656 this->libObjPtr())};
1659 Shared shared() const noexcept
1661 return Shared::createWithRef(*this);
1665 using OptionWithSelectorFieldClass = CommonOptionWithSelectorFieldClass<bt_field_class>;
1666 using ConstOptionWithSelectorFieldClass = CommonOptionWithSelectorFieldClass<const bt_field_class>;
1668 namespace internal {
1670 struct OptionWithSelectorFieldClassTypeDescr
1672 using Const = ConstOptionWithSelectorFieldClass;
1673 using NonConst = OptionWithSelectorFieldClass;
1677 struct TypeDescr<OptionWithSelectorFieldClass> : public OptionWithSelectorFieldClassTypeDescr
1682 struct TypeDescr<ConstOptionWithSelectorFieldClass> : public OptionWithSelectorFieldClassTypeDescr
1686 } /* namespace internal */
1688 template <typename LibObjT>
1689 class CommonOptionWithBoolSelectorFieldClass : public CommonOptionWithSelectorFieldClass<LibObjT>
1692 using typename CommonFieldClass<LibObjT>::_LibObjPtr;
1694 using typename CommonOptionWithSelectorFieldClass<
1695 LibObjT>::_ThisCommonOptionWithSelectorFieldClass;
1698 using Shared = SharedFieldClass<CommonOptionWithBoolSelectorFieldClass<LibObjT>, LibObjT>;
1700 explicit CommonOptionWithBoolSelectorFieldClass(const _LibObjPtr libObjPtr) noexcept :
1701 _ThisCommonOptionWithSelectorFieldClass {libObjPtr}
1703 BT_ASSERT_DBG(this->isOptionWithBoolSelector());
1706 template <typename OtherLibObjT>
1707 CommonOptionWithBoolSelectorFieldClass(
1708 const CommonOptionWithBoolSelectorFieldClass<OtherLibObjT> fc) noexcept :
1709 _ThisCommonOptionWithSelectorFieldClass {fc}
1713 template <typename OtherLibObjT>
1714 CommonOptionWithBoolSelectorFieldClass&
1715 operator=(const CommonOptionWithBoolSelectorFieldClass<OtherLibObjT> fc) noexcept
1717 _ThisCommonOptionWithSelectorFieldClass::operator=(fc);
1721 bool selectorIsReversed() const noexcept
1723 return bt_field_class_option_with_selector_field_bool_selector_is_reversed(
1727 Shared shared() const noexcept
1729 return Shared::createWithRef(*this);
1733 using OptionWithBoolSelectorFieldClass = CommonOptionWithBoolSelectorFieldClass<bt_field_class>;
1735 using ConstOptionWithBoolSelectorFieldClass =
1736 CommonOptionWithBoolSelectorFieldClass<const bt_field_class>;
1738 namespace internal {
1740 struct OptionWithBoolSelectorFieldClassTypeDescr
1742 using Const = ConstOptionWithBoolSelectorFieldClass;
1743 using NonConst = OptionWithBoolSelectorFieldClass;
1747 struct TypeDescr<OptionWithBoolSelectorFieldClass> :
1748 public OptionWithBoolSelectorFieldClassTypeDescr
1753 struct TypeDescr<ConstOptionWithBoolSelectorFieldClass> :
1754 public OptionWithBoolSelectorFieldClassTypeDescr
1758 template <typename RangeSetT>
1759 struct CommonOptionWithIntegerSelectorFieldClassSpec;
1761 /* Functions specific to option field classes with unsigned integer ranges */
1763 struct CommonOptionWithIntegerSelectorFieldClassSpec<ConstUnsignedIntegerRangeSet> final
1765 static const bt_integer_range_set_unsigned *
1766 ranges(const bt_field_class * const libObjPtr) noexcept
1768 return bt_field_class_option_with_selector_field_integer_unsigned_borrow_selector_ranges_const(
1773 /* Functions specific to option field classes with signed ranges */
1775 struct CommonOptionWithIntegerSelectorFieldClassSpec<ConstSignedIntegerRangeSet> final
1777 static const bt_integer_range_set_signed *
1778 ranges(const bt_field_class * const libObjPtr) noexcept
1780 return bt_field_class_option_with_selector_field_integer_signed_borrow_selector_ranges_const(
1785 } /* namespace internal */
1787 template <typename LibObjT, typename RangeSetT>
1788 class CommonOptionWithIntegerSelectorFieldClass : public CommonOptionWithSelectorFieldClass<LibObjT>
1791 using typename CommonFieldClass<LibObjT>::_LibObjPtr;
1793 using typename CommonOptionWithSelectorFieldClass<
1794 LibObjT>::_ThisCommonOptionWithSelectorFieldClass;
1796 using _ThisCommonOptionWithIntegerSelectorFieldClass =
1797 CommonOptionWithIntegerSelectorFieldClass<LibObjT, RangeSetT>;
1800 using Shared = SharedFieldClass<_ThisCommonOptionWithIntegerSelectorFieldClass, LibObjT>;
1802 using RangeSet = RangeSetT;
1804 explicit CommonOptionWithIntegerSelectorFieldClass(const _LibObjPtr libObjPtr) noexcept :
1805 _ThisCommonOptionWithSelectorFieldClass {libObjPtr}
1807 BT_ASSERT_DBG(this->isOptionWithIntegerSelector());
1810 template <typename OtherLibObjT>
1811 CommonOptionWithIntegerSelectorFieldClass(
1812 const CommonOptionWithIntegerSelectorFieldClass<OtherLibObjT, RangeSetT> fc) noexcept :
1813 _ThisCommonOptionWithSelectorFieldClass {fc}
1817 template <typename OtherLibObjT>
1818 CommonOptionWithIntegerSelectorFieldClass&
1819 operator=(const CommonOptionWithIntegerSelectorFieldClass<OtherLibObjT, RangeSetT> fc) noexcept
1821 _ThisCommonOptionWithSelectorFieldClass::operator=(fc);
1825 RangeSet ranges() const noexcept
1827 return RangeSet {internal::CommonOptionWithIntegerSelectorFieldClassSpec<RangeSetT>::ranges(
1828 this->libObjPtr())};
1831 Shared shared() const noexcept
1833 return Shared::createWithRef(*this);
1837 using OptionWithUnsignedIntegerSelectorFieldClass =
1838 CommonOptionWithIntegerSelectorFieldClass<bt_field_class, ConstUnsignedIntegerRangeSet>;
1840 using ConstOptionWithUnsignedIntegerSelectorFieldClass =
1841 CommonOptionWithIntegerSelectorFieldClass<const bt_field_class, ConstUnsignedIntegerRangeSet>;
1843 using OptionWithSignedIntegerSelectorFieldClass =
1844 CommonOptionWithIntegerSelectorFieldClass<bt_field_class, ConstSignedIntegerRangeSet>;
1846 using ConstOptionWithSignedIntegerSelectorFieldClass =
1847 CommonOptionWithIntegerSelectorFieldClass<const bt_field_class, ConstSignedIntegerRangeSet>;
1849 namespace internal {
1851 struct OptionWithUnsignedIntegerSelectorFieldClassTypeDescr
1853 using Const = ConstOptionWithUnsignedIntegerSelectorFieldClass;
1854 using NonConst = OptionWithUnsignedIntegerSelectorFieldClass;
1858 struct TypeDescr<OptionWithUnsignedIntegerSelectorFieldClass> :
1859 public OptionWithUnsignedIntegerSelectorFieldClassTypeDescr
1864 struct TypeDescr<ConstOptionWithUnsignedIntegerSelectorFieldClass> :
1865 public OptionWithUnsignedIntegerSelectorFieldClassTypeDescr
1869 struct OptionWithSignedIntegerSelectorFieldClassTypeDescr
1871 using Const = ConstOptionWithSignedIntegerSelectorFieldClass;
1872 using NonConst = OptionWithSignedIntegerSelectorFieldClass;
1876 struct TypeDescr<OptionWithSignedIntegerSelectorFieldClass> :
1877 public OptionWithSignedIntegerSelectorFieldClassTypeDescr
1882 struct TypeDescr<ConstOptionWithSignedIntegerSelectorFieldClass> :
1883 public OptionWithSignedIntegerSelectorFieldClassTypeDescr
1887 template <typename LibObjT>
1888 struct CommonVariantFieldClassOptionSpec;
1890 /* Functions specific to mutable variant field class options */
1892 struct CommonVariantFieldClassOptionSpec<bt_field_class_variant_option> final
1894 static bt_field_class *fieldClass(bt_field_class_variant_option * const libObjPtr) noexcept
1896 return bt_field_class_variant_option_borrow_field_class(libObjPtr);
1899 static bt_value *userAttributes(bt_field_class_variant_option * const libObjPtr) noexcept
1901 return bt_field_class_variant_option_borrow_user_attributes(libObjPtr);
1905 /* Functions specific to constant variant field class options */
1907 struct CommonVariantFieldClassOptionSpec<const bt_field_class_variant_option> final
1909 static const bt_field_class *
1910 fieldClass(const bt_field_class_variant_option * const libObjPtr) noexcept
1912 return bt_field_class_variant_option_borrow_field_class_const(libObjPtr);
1915 static const bt_value *
1916 userAttributes(const bt_field_class_variant_option * const libObjPtr) noexcept
1918 return bt_field_class_variant_option_borrow_user_attributes_const(libObjPtr);
1922 } /* namespace internal */
1924 template <typename LibObjT>
1925 class CommonVariantFieldClassOption : public BorrowedObject<LibObjT>
1928 using typename BorrowedObject<LibObjT>::_ThisBorrowedObject;
1929 using typename BorrowedObject<LibObjT>::_LibObjPtr;
1932 typename std::conditional<std::is_const<LibObjT>::value, ConstFieldClass, FieldClass>::type;
1935 using UserAttributes =
1936 typename std::conditional<std::is_const<LibObjT>::value, ConstMapValue, MapValue>::type;
1938 explicit CommonVariantFieldClassOption(const _LibObjPtr libObjPtr) noexcept :
1939 _ThisBorrowedObject {libObjPtr}
1943 template <typename OtherLibObjT>
1944 CommonVariantFieldClassOption(const CommonVariantFieldClassOption<OtherLibObjT> fc) noexcept :
1945 _ThisBorrowedObject {fc}
1949 template <typename OtherLibObjT>
1950 CommonVariantFieldClassOption&
1951 operator=(const CommonVariantFieldClassOption<OtherLibObjT> fc) noexcept
1953 _ThisBorrowedObject::operator=(fc);
1957 nonstd::optional<bpstd::string_view> name() const noexcept
1959 const auto name = bt_field_class_variant_option_get_name(this->libObjPtr());
1965 return nonstd::nullopt;
1968 ConstFieldClass fieldClass() const noexcept
1970 return ConstFieldClass {internal::CommonVariantFieldClassOptionSpec<
1971 const bt_field_class_variant_option>::fieldClass(this->libObjPtr())};
1974 _FieldClass fieldClass() noexcept
1976 return _FieldClass {
1977 internal::CommonVariantFieldClassOptionSpec<LibObjT>::fieldClass(this->libObjPtr())};
1980 template <typename LibValT>
1981 void userAttributes(const CommonMapValue<LibValT> userAttrs)
1983 static_assert(!std::is_const<LibObjT>::value, "`LibObjT` must NOT be `const`.");
1985 bt_field_class_variant_option_set_user_attributes(this->libObjPtr(), userAttrs.libObjPtr());
1988 ConstMapValue userAttributes() const noexcept
1990 return ConstMapValue {internal::CommonVariantFieldClassOptionSpec<
1991 const bt_field_class_variant_option>::userAttributes(this->libObjPtr())};
1994 UserAttributes userAttributes() noexcept
1996 return UserAttributes {internal::CommonVariantFieldClassOptionSpec<LibObjT>::userAttributes(
1997 this->libObjPtr())};
2001 using VariantFieldClassOption = CommonVariantFieldClassOption<bt_field_class_variant_option>;
2003 using ConstVariantFieldClassOption =
2004 CommonVariantFieldClassOption<const bt_field_class_variant_option>;
2006 namespace internal {
2008 struct VariantFieldClassOptionTypeDescr
2010 using Const = ConstVariantFieldClassOption;
2011 using NonConst = VariantFieldClassOption;
2015 struct TypeDescr<VariantFieldClassOption> : public VariantFieldClassOptionTypeDescr
2020 struct TypeDescr<ConstVariantFieldClassOption> : public VariantFieldClassOptionTypeDescr
2024 template <typename LibObjT>
2025 struct ConstVariantWithIntegerSelectorFieldClassOptionSpec;
2027 /* Functions specific to variant field class options with unsigned integer selector */
2029 struct ConstVariantWithIntegerSelectorFieldClassOptionSpec<
2030 const bt_field_class_variant_with_selector_field_integer_unsigned_option>
2033 static const bt_integer_range_set_unsigned *
2034 ranges(const bt_field_class_variant_with_selector_field_integer_unsigned_option
2035 * const libObjPtr) noexcept
2037 return bt_field_class_variant_with_selector_field_integer_unsigned_option_borrow_ranges_const(
2041 static const bt_field_class_variant_option *
2042 asBaseOption(const bt_field_class_variant_with_selector_field_integer_unsigned_option
2043 * const libObjPtr) noexcept
2045 return bt_field_class_variant_with_selector_field_integer_unsigned_option_as_option_const(
2050 /* Functions specific to variant field class options with signed integer selector */
2052 struct ConstVariantWithIntegerSelectorFieldClassOptionSpec<
2053 const bt_field_class_variant_with_selector_field_integer_signed_option>
2056 static const bt_integer_range_set_signed *
2057 ranges(const bt_field_class_variant_with_selector_field_integer_signed_option
2058 * const libObjPtr) noexcept
2060 return bt_field_class_variant_with_selector_field_integer_signed_option_borrow_ranges_const(
2064 static const bt_field_class_variant_option *
2065 asBaseOption(const bt_field_class_variant_with_selector_field_integer_signed_option
2066 * const libObjPtr) noexcept
2068 return bt_field_class_variant_with_selector_field_integer_signed_option_as_option_const(
2073 } /* namespace internal */
2075 template <typename LibObjT>
2076 class ConstVariantWithIntegerSelectorFieldClassOption : public BorrowedObject<LibObjT>
2079 using typename BorrowedObject<LibObjT>::_ThisBorrowedObject;
2080 using typename BorrowedObject<LibObjT>::_LibObjPtr;
2081 using _Spec = internal::ConstVariantWithIntegerSelectorFieldClassOptionSpec<LibObjT>;
2084 using RangeSet = typename std::conditional<
2087 const bt_field_class_variant_with_selector_field_integer_unsigned_option>::value,
2088 ConstUnsignedIntegerRangeSet, ConstSignedIntegerRangeSet>::type;
2090 explicit ConstVariantWithIntegerSelectorFieldClassOption(const _LibObjPtr libObjPtr) noexcept :
2091 _ThisBorrowedObject {libObjPtr}
2095 template <typename OtherLibObjT>
2096 ConstVariantWithIntegerSelectorFieldClassOption(
2097 const ConstVariantWithIntegerSelectorFieldClassOption<OtherLibObjT> fc) noexcept :
2098 _ThisBorrowedObject {fc}
2102 template <typename OtherLibObjT>
2103 ConstVariantWithIntegerSelectorFieldClassOption&
2104 operator=(const ConstVariantWithIntegerSelectorFieldClassOption<OtherLibObjT> fc) noexcept
2106 _ThisBorrowedObject::operator=(fc);
2110 ConstVariantFieldClassOption asBaseOption() const noexcept
2112 return ConstVariantFieldClassOption {_Spec::asBaseOption(this->libObjPtr())};
2115 nonstd::optional<bpstd::string_view> name() const noexcept
2117 return this->asBaseOption().name();
2120 ConstFieldClass fieldClass() const noexcept
2122 return this->asBaseOption().fieldClass();
2125 RangeSet ranges() const noexcept
2127 return RangeSet {_Spec::ranges(this->libObjPtr())};
2131 using ConstVariantWithUnsignedIntegerSelectorFieldClassOption =
2132 ConstVariantWithIntegerSelectorFieldClassOption<
2133 const bt_field_class_variant_with_selector_field_integer_unsigned_option>;
2135 using ConstVariantWithSignedIntegerSelectorFieldClassOption =
2136 ConstVariantWithIntegerSelectorFieldClassOption<
2137 const bt_field_class_variant_with_selector_field_integer_signed_option>;
2139 namespace internal {
2141 template <typename LibObjT>
2142 struct CommonVariantFieldClassSpec;
2144 /* Functions specific to mutable variant field classes */
2146 struct CommonVariantFieldClassSpec<bt_field_class> final
2148 static bt_field_class_variant_option *optionByIndex(bt_field_class * const libObjPtr,
2149 const std::uint64_t index) noexcept
2151 return bt_field_class_variant_borrow_option_by_index(libObjPtr, index);
2154 static bt_field_class_variant_option *optionByName(bt_field_class * const libObjPtr,
2155 const char * const name) noexcept
2157 return bt_field_class_variant_borrow_option_by_name(libObjPtr, name);
2161 /* Functions specific to constant variant field classes */
2163 struct CommonVariantFieldClassSpec<const bt_field_class> final
2165 static const bt_field_class_variant_option *
2166 optionByIndex(const bt_field_class * const libObjPtr, const std::uint64_t index) noexcept
2168 return bt_field_class_variant_borrow_option_by_index_const(libObjPtr, index);
2171 static const bt_field_class_variant_option *optionByName(const bt_field_class * const libObjPtr,
2172 const char * const name) noexcept
2174 return bt_field_class_variant_borrow_option_by_name_const(libObjPtr, name);
2178 } /* namespace internal */
2180 template <typename LibObjT>
2181 class CommonVariantFieldClass : public CommonFieldClass<LibObjT>
2184 using typename CommonFieldClass<LibObjT>::_ThisCommonFieldClass;
2187 using typename CommonFieldClass<LibObjT>::_LibObjPtr;
2188 using _ThisCommonVariantFieldClass = CommonVariantFieldClass<LibObjT>;
2191 using Shared = SharedFieldClass<CommonVariantFieldClass<LibObjT>, LibObjT>;
2194 typename std::conditional<std::is_const<LibObjT>::value, ConstVariantFieldClassOption,
2195 VariantFieldClassOption>::type;
2197 using Iterator = CommonIterator<CommonVariantFieldClass, Option>;
2199 explicit CommonVariantFieldClass(const _LibObjPtr libObjPtr) noexcept :
2200 _ThisCommonFieldClass {libObjPtr}
2202 BT_ASSERT_DBG(this->isVariant());
2205 template <typename OtherLibObjT>
2206 CommonVariantFieldClass(const CommonVariantFieldClass<OtherLibObjT> fc) noexcept :
2207 _ThisCommonFieldClass {fc}
2211 template <typename OtherLibObjT>
2212 CommonVariantFieldClass& operator=(const CommonVariantFieldClass<OtherLibObjT> fc) noexcept
2214 _ThisCommonFieldClass::operator=(fc);
2218 std::uint64_t size() const noexcept
2220 return bt_field_class_variant_get_option_count(this->libObjPtr());
2223 Iterator begin() const noexcept
2225 return Iterator {*this, 0};
2228 Iterator end() const noexcept
2230 return Iterator {*this, this->size()};
2233 ConstVariantFieldClassOption operator[](const std::uint64_t index) const noexcept
2235 return ConstVariantFieldClassOption {
2236 internal::CommonVariantFieldClassSpec<const bt_field_class>::optionByIndex(
2237 this->libObjPtr(), index)};
2240 Option operator[](const std::uint64_t index) noexcept
2242 return Option {internal::CommonVariantFieldClassSpec<LibObjT>::optionByIndex(
2243 this->libObjPtr(), index)};
2246 nonstd::optional<ConstVariantFieldClassOption>
2247 operator[](const char * const name) const noexcept
2249 const auto libObjPtr =
2250 internal::CommonVariantFieldClassSpec<const bt_field_class>::optionByName(
2251 this->libObjPtr(), name);
2254 return ConstVariantFieldClassOption {libObjPtr};
2257 return nonstd::nullopt;
2260 nonstd::optional<ConstVariantFieldClassOption>
2261 operator[](const std::string& name) const noexcept
2263 return (*this)[name.data()];
2266 nonstd::optional<Option> operator[](const char * const name) noexcept
2268 const auto libObjPtr =
2269 internal::CommonVariantFieldClassSpec<LibObjT>::optionByName(this->libObjPtr(), name);
2272 return Option {libObjPtr};
2275 return nonstd::nullopt;
2278 nonstd::optional<Option> operator[](const std::string& name) noexcept
2280 return (*this)[name.data()];
2283 Shared shared() const noexcept
2285 return Shared::createWithRef(*this);
2289 using VariantFieldClass = CommonVariantFieldClass<bt_field_class>;
2290 using ConstVariantFieldClass = CommonVariantFieldClass<const bt_field_class>;
2292 namespace internal {
2294 struct VariantFieldClassTypeDescr
2296 using Const = ConstVariantFieldClass;
2297 using NonConst = VariantFieldClass;
2301 struct TypeDescr<VariantFieldClass> : public VariantFieldClassTypeDescr
2306 struct TypeDescr<ConstVariantFieldClass> : public VariantFieldClassTypeDescr
2310 } /* namespace internal */
2312 template <typename LibObjT>
2313 class CommonVariantWithoutSelectorFieldClass : public CommonVariantFieldClass<LibObjT>
2316 using typename CommonVariantFieldClass<LibObjT>::_ThisCommonVariantFieldClass;
2317 using typename CommonFieldClass<LibObjT>::_LibObjPtr;
2320 using Shared = SharedFieldClass<CommonVariantWithoutSelectorFieldClass<LibObjT>, LibObjT>;
2322 explicit CommonVariantWithoutSelectorFieldClass(const _LibObjPtr libObjPtr) noexcept :
2323 _ThisCommonVariantFieldClass {libObjPtr}
2325 BT_ASSERT_DBG(this->isVariantWithoutSelector());
2328 template <typename OtherLibObjT>
2329 CommonVariantWithoutSelectorFieldClass(
2330 const CommonVariantWithoutSelectorFieldClass<OtherLibObjT> fc) noexcept :
2331 _ThisCommonVariantFieldClass {fc}
2335 template <typename OtherLibObjT>
2336 CommonVariantWithoutSelectorFieldClass&
2337 operator=(const CommonVariantWithoutSelectorFieldClass<OtherLibObjT> fc) noexcept
2339 _ThisCommonVariantFieldClass::operator=(fc);
2343 void appendOption(const char * const name, const FieldClass fc)
2345 static_assert(!std::is_const<LibObjT>::value, "`LibObjT` must NOT be `const`.");
2347 const auto status = bt_field_class_variant_without_selector_append_option(
2348 this->libObjPtr(), name, fc.libObjPtr());
2351 BT_FIELD_CLASS_VARIANT_WITHOUT_SELECTOR_FIELD_APPEND_OPTION_STATUS_MEMORY_ERROR) {
2352 throw MemoryError {};
2356 void appendOption(const nonstd::optional<std::string>& name, const FieldClass fc)
2358 this->appendOption(name ? name->data() : nullptr, fc);
2361 Shared shared() const noexcept
2363 return Shared::createWithRef(*this);
2367 using VariantWithoutSelectorFieldClass = CommonVariantWithoutSelectorFieldClass<bt_field_class>;
2368 using ConstVariantWithoutSelectorFieldClass =
2369 CommonVariantWithoutSelectorFieldClass<const bt_field_class>;
2371 namespace internal {
2373 struct VariantWithoutSelectorFieldClassTypeDescr
2375 using Const = ConstVariantWithoutSelectorFieldClass;
2376 using NonConst = VariantWithoutSelectorFieldClass;
2380 struct TypeDescr<VariantWithoutSelectorFieldClass> :
2381 public VariantWithoutSelectorFieldClassTypeDescr
2386 struct TypeDescr<ConstVariantWithoutSelectorFieldClass> :
2387 public VariantWithoutSelectorFieldClassTypeDescr
2391 template <typename OptionT>
2392 struct CommonVariantWithIntegerSelectorFieldClassSpec;
2394 /* Functions specific to variant field classes with unsigned integer selector */
2396 struct CommonVariantWithIntegerSelectorFieldClassSpec<
2397 ConstVariantWithUnsignedIntegerSelectorFieldClassOption>
2400 static const bt_field_class_variant_with_selector_field_integer_unsigned_option *
2401 optionByIndex(const bt_field_class * const libObjPtr, const std::uint64_t index) noexcept
2403 return bt_field_class_variant_with_selector_field_integer_unsigned_borrow_option_by_index_const(
2407 static const bt_field_class_variant_with_selector_field_integer_unsigned_option *
2408 optionByName(const bt_field_class * const libObjPtr, const char * const name) noexcept
2410 return bt_field_class_variant_with_selector_field_integer_unsigned_borrow_option_by_name_const(
2414 static bt_field_class_variant_with_selector_field_integer_append_option_status
2415 appendOption(bt_field_class * const libObjPtr, const char * const name,
2416 bt_field_class * const libOptFcPtr,
2417 const bt_integer_range_set_unsigned * const libRangesPtr)
2419 return bt_field_class_variant_with_selector_field_integer_unsigned_append_option(
2420 libObjPtr, name, libOptFcPtr, libRangesPtr);
2424 /* Functions specific to variant field classes with signed integer selector */
2426 struct CommonVariantWithIntegerSelectorFieldClassSpec<
2427 ConstVariantWithSignedIntegerSelectorFieldClassOption>
2430 static const bt_field_class_variant_with_selector_field_integer_signed_option *
2431 optionByIndex(const bt_field_class * const libObjPtr, const std::uint64_t index) noexcept
2433 return bt_field_class_variant_with_selector_field_integer_signed_borrow_option_by_index_const(
2437 static const bt_field_class_variant_with_selector_field_integer_signed_option *
2438 optionByName(const bt_field_class * const libObjPtr, const char * const name) noexcept
2440 return bt_field_class_variant_with_selector_field_integer_signed_borrow_option_by_name_const(
2444 static bt_field_class_variant_with_selector_field_integer_append_option_status
2445 appendOption(bt_field_class * const libObjPtr, const char * const name,
2446 bt_field_class * const libOptFcPtr,
2447 const bt_integer_range_set_signed * const libRangesPtr)
2449 return bt_field_class_variant_with_selector_field_integer_signed_append_option(
2450 libObjPtr, name, libOptFcPtr, libRangesPtr);
2454 } /* namespace internal */
2456 template <typename LibObjT>
2457 class CommonVariantWithSelectorFieldClass : public CommonVariantFieldClass<LibObjT>
2460 using typename CommonVariantFieldClass<LibObjT>::_ThisCommonVariantFieldClass;
2463 using typename CommonFieldClass<LibObjT>::_LibObjPtr;
2464 using _ThisCommonVariantWithSelectorFieldClass = CommonVariantWithSelectorFieldClass<LibObjT>;
2467 using Shared = SharedFieldClass<_ThisCommonVariantWithSelectorFieldClass, LibObjT>;
2469 explicit CommonVariantWithSelectorFieldClass(const _LibObjPtr libObjPtr) noexcept :
2470 _ThisCommonVariantFieldClass {libObjPtr}
2472 BT_ASSERT_DBG(this->isVariantWithSelector());
2475 template <typename OtherLibObjT>
2476 CommonVariantWithSelectorFieldClass(
2477 const CommonVariantWithSelectorFieldClass<OtherLibObjT> fc) noexcept :
2478 _ThisCommonVariantFieldClass {fc}
2482 template <typename OtherLibObjT>
2483 CommonVariantWithSelectorFieldClass&
2484 operator=(const CommonVariantWithSelectorFieldClass<OtherLibObjT> fc) noexcept
2486 _ThisCommonVariantFieldClass::operator=(fc);
2490 ConstFieldPath selectorFieldPath() const noexcept
2492 return ConstFieldPath {
2493 bt_field_class_variant_with_selector_field_borrow_selector_field_path_const(
2494 this->libObjPtr())};
2497 Shared shared() const noexcept
2499 return Shared::createWithRef(*this);
2503 using VariantWithSelectorFieldClass = CommonVariantWithSelectorFieldClass<bt_field_class>;
2504 using ConstVariantWithSelectorFieldClass =
2505 CommonVariantWithSelectorFieldClass<const bt_field_class>;
2507 template <typename LibObjT, typename OptionT>
2508 class CommonVariantWithIntegerSelectorFieldClass :
2509 public CommonVariantWithSelectorFieldClass<LibObjT>
2512 using typename CommonVariantWithSelectorFieldClass<
2513 LibObjT>::_ThisCommonVariantWithSelectorFieldClass;
2514 using typename CommonFieldClass<LibObjT>::_LibObjPtr;
2515 using _ThisCommonVariantWithIntegerSelectorFieldClass =
2516 CommonVariantWithIntegerSelectorFieldClass<LibObjT, OptionT>;
2518 using _Spec = internal::CommonVariantWithIntegerSelectorFieldClassSpec<OptionT>;
2521 using Shared = SharedFieldClass<_ThisCommonVariantWithIntegerSelectorFieldClass, LibObjT>;
2523 using Option = OptionT;
2525 CommonIterator<CommonVariantWithIntegerSelectorFieldClass<LibObjT, Option>, Option>;
2527 explicit CommonVariantWithIntegerSelectorFieldClass(const _LibObjPtr libObjPtr) noexcept :
2528 _ThisCommonVariantWithSelectorFieldClass {libObjPtr}
2530 BT_ASSERT_DBG(this->isVariant());
2533 template <typename OtherLibObjT>
2534 CommonVariantWithIntegerSelectorFieldClass(
2535 const CommonVariantWithIntegerSelectorFieldClass<OtherLibObjT, OptionT> fc) noexcept :
2536 _ThisCommonVariantWithSelectorFieldClass {fc}
2540 template <typename OtherLibObjT>
2541 CommonVariantWithIntegerSelectorFieldClass&
2542 operator=(const CommonVariantWithIntegerSelectorFieldClass<OtherLibObjT, OptionT> fc) noexcept
2544 _ThisCommonVariantWithSelectorFieldClass::operator=(fc);
2548 Option operator[](const std::uint64_t index) const noexcept
2550 return Option {_Spec::optionByIndex(this->libObjPtr(), index)};
2553 nonstd::optional<Option> operator[](const char * const name) const noexcept
2555 const auto libObjPtr = _Spec::optionByName(this->libObjPtr(), name);
2558 return Option {libObjPtr};
2561 return nonstd::nullopt;
2564 nonstd::optional<Option> operator[](const std::string& name) const noexcept
2566 return (*this)[name.data()];
2569 void appendOption(const char * const name, const FieldClass fc,
2570 const typename Option::RangeSet ranges)
2572 static_assert(!std::is_const<LibObjT>::value, "`LibObjT` must NOT be `const`.");
2575 _Spec::appendOption(this->libObjPtr(), name, fc.libObjPtr(), ranges.libObjPtr());
2578 BT_FIELD_CLASS_VARIANT_WITH_SELECTOR_FIELD_APPEND_OPTION_STATUS_MEMORY_ERROR) {
2579 throw MemoryError {};
2583 void appendOption(const nonstd::optional<std::string>& name, const FieldClass fc,
2584 const typename Option::RangeSet ranges)
2586 this->appendOption(name ? name->data() : nullptr, fc, ranges);
2589 Iterator begin() const noexcept
2591 return Iterator {*this, 0};
2594 Iterator end() const noexcept
2596 return Iterator {*this, this->size()};
2599 Shared shared() const noexcept
2601 return Shared::createWithRef(*this);
2605 using VariantWithUnsignedIntegerSelectorFieldClass = CommonVariantWithIntegerSelectorFieldClass<
2606 bt_field_class, ConstVariantWithUnsignedIntegerSelectorFieldClassOption>;
2608 using ConstVariantWithUnsignedIntegerSelectorFieldClass =
2609 CommonVariantWithIntegerSelectorFieldClass<
2610 const bt_field_class, ConstVariantWithUnsignedIntegerSelectorFieldClassOption>;
2612 using VariantWithSignedIntegerSelectorFieldClass = CommonVariantWithIntegerSelectorFieldClass<
2613 bt_field_class, ConstVariantWithSignedIntegerSelectorFieldClassOption>;
2615 using ConstVariantWithSignedIntegerSelectorFieldClass = CommonVariantWithIntegerSelectorFieldClass<
2616 const bt_field_class, ConstVariantWithSignedIntegerSelectorFieldClassOption>;
2618 namespace internal {
2620 struct VariantWithUnsignedIntegerSelectorFieldClassTypeDescr
2622 using Const = ConstVariantWithUnsignedIntegerSelectorFieldClass;
2623 using NonConst = VariantWithUnsignedIntegerSelectorFieldClass;
2627 struct TypeDescr<VariantWithUnsignedIntegerSelectorFieldClass> :
2628 public VariantWithUnsignedIntegerSelectorFieldClassTypeDescr
2633 struct TypeDescr<ConstVariantWithUnsignedIntegerSelectorFieldClass> :
2634 public VariantWithUnsignedIntegerSelectorFieldClassTypeDescr
2638 struct VariantWithSignedIntegerSelectorFieldClassTypeDescr
2640 using Const = ConstVariantWithSignedIntegerSelectorFieldClass;
2641 using NonConst = VariantWithSignedIntegerSelectorFieldClass;
2645 struct TypeDescr<VariantWithSignedIntegerSelectorFieldClass> :
2646 public VariantWithSignedIntegerSelectorFieldClassTypeDescr
2651 struct TypeDescr<ConstVariantWithSignedIntegerSelectorFieldClass> :
2652 public VariantWithSignedIntegerSelectorFieldClassTypeDescr
2656 } /* namespace internal */
2658 template <typename LibObjT>
2659 CommonBitArrayFieldClass<LibObjT> CommonFieldClass<LibObjT>::asBitArray() const noexcept
2661 BT_ASSERT_DBG(this->isBitArray());
2662 return CommonBitArrayFieldClass<LibObjT> {this->libObjPtr()};
2665 template <typename LibObjT>
2666 CommonIntegerFieldClass<LibObjT> CommonFieldClass<LibObjT>::asInteger() const noexcept
2668 BT_ASSERT_DBG(this->isInteger());
2669 return CommonIntegerFieldClass<LibObjT> {this->libObjPtr()};
2672 template <typename LibObjT>
2673 CommonBaseEnumerationFieldClass<LibObjT> CommonFieldClass<LibObjT>::asEnumeration() const noexcept
2675 BT_ASSERT_DBG(this->isEnumeration());
2676 return CommonBaseEnumerationFieldClass<LibObjT> {this->libObjPtr()};
2679 template <typename LibObjT>
2680 CommonEnumerationFieldClass<LibObjT, ConstUnsignedEnumerationFieldClassMapping>
2681 CommonFieldClass<LibObjT>::asUnsignedEnumeration() const noexcept
2683 BT_ASSERT_DBG(this->isUnsignedEnumeration());
2684 return CommonEnumerationFieldClass<LibObjT, ConstUnsignedEnumerationFieldClassMapping> {
2688 template <typename LibObjT>
2689 CommonEnumerationFieldClass<LibObjT, ConstSignedEnumerationFieldClassMapping>
2690 CommonFieldClass<LibObjT>::asSignedEnumeration() const noexcept
2692 BT_ASSERT_DBG(this->isSignedEnumeration());
2693 return CommonEnumerationFieldClass<LibObjT, ConstSignedEnumerationFieldClassMapping> {
2697 template <typename LibObjT>
2698 CommonStructureFieldClass<LibObjT> CommonFieldClass<LibObjT>::asStructure() const noexcept
2700 BT_ASSERT_DBG(this->isStructure());
2701 return CommonStructureFieldClass<LibObjT> {this->libObjPtr()};
2704 template <typename LibObjT>
2705 CommonArrayFieldClass<LibObjT> CommonFieldClass<LibObjT>::asArray() const noexcept
2707 BT_ASSERT_DBG(this->isArray());
2708 return CommonArrayFieldClass<LibObjT> {this->libObjPtr()};
2711 template <typename LibObjT>
2712 CommonStaticArrayFieldClass<LibObjT> CommonFieldClass<LibObjT>::asStaticArray() const noexcept
2714 BT_ASSERT_DBG(this->isStaticArray());
2715 return CommonStaticArrayFieldClass<LibObjT> {this->libObjPtr()};
2718 template <typename LibObjT>
2719 CommonDynamicArrayWithLengthFieldClass<LibObjT>
2720 CommonFieldClass<LibObjT>::asDynamicArrayWithLength() const noexcept
2722 BT_ASSERT_DBG(this->isDynamicArrayWithLength());
2723 return CommonDynamicArrayWithLengthFieldClass<LibObjT> {this->libObjPtr()};
2726 template <typename LibObjT>
2727 CommonOptionFieldClass<LibObjT> CommonFieldClass<LibObjT>::asOption() const noexcept
2729 BT_ASSERT_DBG(this->isOption());
2730 return CommonOptionFieldClass<LibObjT> {this->libObjPtr()};
2733 template <typename LibObjT>
2734 CommonOptionWithSelectorFieldClass<LibObjT>
2735 CommonFieldClass<LibObjT>::asOptionWithSelector() const noexcept
2737 BT_ASSERT_DBG(this->isOptionWithSelector());
2738 return CommonOptionWithSelectorFieldClass<LibObjT> {this->libObjPtr()};
2741 template <typename LibObjT>
2742 CommonOptionWithBoolSelectorFieldClass<LibObjT>
2743 CommonFieldClass<LibObjT>::asOptionWithBoolSelector() const noexcept
2745 BT_ASSERT_DBG(this->isOptionWithBoolSelector());
2746 return CommonOptionWithBoolSelectorFieldClass<LibObjT> {this->libObjPtr()};
2749 template <typename LibObjT>
2750 CommonOptionWithIntegerSelectorFieldClass<LibObjT, ConstUnsignedIntegerRangeSet>
2751 CommonFieldClass<LibObjT>::asOptionWithUnsignedIntegerSelector() const noexcept
2753 BT_ASSERT_DBG(this->isOptionWithUnsignedIntegerSelector());
2754 return CommonOptionWithIntegerSelectorFieldClass<LibObjT, ConstUnsignedIntegerRangeSet> {
2758 template <typename LibObjT>
2759 CommonOptionWithIntegerSelectorFieldClass<LibObjT, ConstSignedIntegerRangeSet>
2760 CommonFieldClass<LibObjT>::asOptionWithSignedIntegerSelector() const noexcept
2762 BT_ASSERT_DBG(this->isOptionWithSignedIntegerSelector());
2763 return CommonOptionWithIntegerSelectorFieldClass<LibObjT, ConstSignedIntegerRangeSet> {
2767 template <typename LibObjT>
2768 CommonVariantFieldClass<LibObjT> CommonFieldClass<LibObjT>::asVariant() const noexcept
2770 BT_ASSERT_DBG(this->isVariant());
2771 return CommonVariantFieldClass<LibObjT> {this->libObjPtr()};
2774 template <typename LibObjT>
2775 CommonVariantWithoutSelectorFieldClass<LibObjT>
2776 CommonFieldClass<LibObjT>::asVariantWithoutSelector() const noexcept
2778 BT_ASSERT_DBG(this->isVariantWithoutSelector());
2779 return CommonVariantWithoutSelectorFieldClass<LibObjT> {this->libObjPtr()};
2782 template <typename LibObjT>
2783 CommonVariantWithSelectorFieldClass<LibObjT>
2784 CommonFieldClass<LibObjT>::asVariantWithSelector() const noexcept
2786 BT_ASSERT_DBG(this->isVariantWithSelector());
2787 return CommonVariantWithSelectorFieldClass<LibObjT> {this->libObjPtr()};
2790 template <typename LibObjT>
2791 CommonVariantWithIntegerSelectorFieldClass<LibObjT,
2792 ConstVariantWithUnsignedIntegerSelectorFieldClassOption>
2793 CommonFieldClass<LibObjT>::asVariantWithUnsignedIntegerSelector() const noexcept
2795 BT_ASSERT_DBG(this->isVariantWithUnsignedIntegerSelector());
2796 return CommonVariantWithIntegerSelectorFieldClass<
2797 LibObjT, ConstVariantWithUnsignedIntegerSelectorFieldClassOption> {this->libObjPtr()};
2800 template <typename LibObjT>
2801 CommonVariantWithIntegerSelectorFieldClass<LibObjT,
2802 ConstVariantWithSignedIntegerSelectorFieldClassOption>
2803 CommonFieldClass<LibObjT>::asVariantWithSignedIntegerSelector() const noexcept
2805 BT_ASSERT_DBG(this->isVariantWithSignedIntegerSelector());
2806 return CommonVariantWithIntegerSelectorFieldClass<
2807 LibObjT, ConstVariantWithSignedIntegerSelectorFieldClassOption> {this->libObjPtr()};
2810 } /* namespace bt2 */
2812 #endif /* BABELTRACE_CPP_COMMON_BT2_FIELD_CLASS_HPP */