CTF writer: use own `bt_ctf_object` and `bt_ctf_value` internal APIs
[babeltrace.git] / lib / ctf-writer / values.c
diff --git a/lib/ctf-writer/values.c b/lib/ctf-writer/values.c
new file mode 100644 (file)
index 0000000..e67d8b5
--- /dev/null
@@ -0,0 +1,1347 @@
+/*
+ * Copyright (c) 2015 EfficiOS Inc. and Linux Foundation
+ * Copyright (c) 2015 Philippe Proulx <pproulx@efficios.com>
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+#define BT_LOG_TAG "CTF-WRITER-VALUES"
+#include <babeltrace/lib-logging-internal.h>
+
+#include <stdlib.h>
+#include <string.h>
+#include <string.h>
+#include <inttypes.h>
+#include <babeltrace/compiler-internal.h>
+#include <babeltrace/common-internal.h>
+#include <babeltrace/ctf-writer/object.h>
+#include <babeltrace/ctf-writer/values-internal.h>
+#include <babeltrace/compat/glib-internal.h>
+#include <babeltrace/types.h>
+#include <babeltrace/ctf-writer/object-internal.h>
+#include <babeltrace/ctf-writer/values-internal.h>
+#include <babeltrace/assert-internal.h>
+#include <babeltrace/assert-pre-internal.h>
+
+#define BT_CTF_VALUE_FROM_CONCRETE(_concrete) ((struct bt_ctf_value *) (_concrete))
+#define BT_CTF_VALUE_TO_BOOL(_base) ((struct bt_ctf_value_bool *) (_base))
+#define BT_CTF_VALUE_TO_INTEGER(_base) ((struct bt_ctf_value_integer *) (_base))
+#define BT_CTF_VALUE_TO_REAL(_base) ((struct bt_ctf_value_real *) (_base))
+#define BT_CTF_VALUE_TO_STRING(_base) ((struct bt_ctf_value_string *) (_base))
+#define BT_CTF_VALUE_TO_ARRAY(_base) ((struct bt_ctf_value_array *) (_base))
+#define BT_CTF_VALUE_TO_MAP(_base) ((struct bt_ctf_value_map *) (_base))
+
+#define BT_ASSERT_PRE_VALUE_IS_TYPE(_value, _type)                     \
+       BT_ASSERT_PRE(((struct bt_ctf_value *) (_value))->type == (_type),      \
+               "Value has the wrong type ID: expected-type=%d, "       \
+               "%![value-]+v", (_type),        \
+               (_value))
+
+#define BT_ASSERT_PRE_VALUE_HOT(_value, _name)                         \
+       BT_ASSERT_PRE_HOT(((struct bt_ctf_value *) (_value)), (_name),  \
+               ": %!+v", (_value))
+
+#define BT_ASSERT_PRE_VALUE_INDEX_IN_BOUNDS(_index, _count)            \
+       BT_ASSERT_PRE((_index) < (_count),                              \
+               "Index is out of bound: "                               \
+               "index=%" PRIu64 ", count=%u", (_index), (_count));
+
+struct bt_ctf_value {
+       struct bt_ctf_object base;
+       enum bt_ctf_value_type type;
+       bt_bool frozen;
+};
+
+static
+void bt_ctf_value_null_instance_release_func(struct bt_ctf_object *obj)
+{
+       BT_LOGW("Releasing the null value singleton: addr=%p", obj);
+}
+
+static
+struct bt_ctf_value bt_ctf_value_null_instance = {
+       .base = {
+               .is_shared = true,
+               .ref_count = 1,
+               .release_func = bt_ctf_value_null_instance_release_func,
+               .spec_release_func = NULL,
+               .parent_is_owner_listener_func = NULL,
+               .parent = NULL,
+       },
+       .type = BT_CTF_VALUE_TYPE_NULL,
+       .frozen = BT_TRUE,
+};
+
+struct bt_ctf_value *bt_ctf_value_null = &bt_ctf_value_null_instance;
+struct bt_ctf_private_value *bt_ctf_private_value_null =
+       (void *) &bt_ctf_value_null_instance;
+
+struct bt_ctf_value_bool {
+       struct bt_ctf_value base;
+       bt_bool value;
+};
+
+struct bt_ctf_value_integer {
+       struct bt_ctf_value base;
+       int64_t value;
+};
+
+struct bt_ctf_value_real {
+       struct bt_ctf_value base;
+       double value;
+};
+
+struct bt_ctf_value_string {
+       struct bt_ctf_value base;
+       GString *gstr;
+};
+
+struct bt_ctf_value_array {
+       struct bt_ctf_value base;
+       GPtrArray *garray;
+};
+
+struct bt_ctf_value_map {
+       struct bt_ctf_value base;
+       GHashTable *ght;
+};
+
+static
+void bt_ctf_value_destroy(struct bt_ctf_object *obj);
+
+static
+void bt_ctf_value_string_destroy(struct bt_ctf_value *object)
+{
+       g_string_free(BT_CTF_VALUE_TO_STRING(object)->gstr, TRUE);
+       BT_CTF_VALUE_TO_STRING(object)->gstr = NULL;
+}
+
+static
+void bt_ctf_value_array_destroy(struct bt_ctf_value *object)
+{
+       /*
+        * Pointer array's registered value destructor will take care
+        * of putting each contained object.
+        */
+       g_ptr_array_free(BT_CTF_VALUE_TO_ARRAY(object)->garray, TRUE);
+       BT_CTF_VALUE_TO_ARRAY(object)->garray = NULL;
+}
+
+static
+void bt_ctf_value_map_destroy(struct bt_ctf_value *object)
+{
+       /*
+        * Hash table's registered value destructor will take care of
+        * putting each contained object. Keys are GQuarks and cannot
+        * be destroyed anyway.
+        */
+       g_hash_table_destroy(BT_CTF_VALUE_TO_MAP(object)->ght);
+       BT_CTF_VALUE_TO_MAP(object)->ght = NULL;
+}
+
+static
+void (* const destroy_funcs[])(struct bt_ctf_value *) = {
+       [BT_CTF_VALUE_TYPE_NULL] =              NULL,
+       [BT_CTF_VALUE_TYPE_BOOL] =              NULL,
+       [BT_CTF_VALUE_TYPE_INTEGER] =   NULL,
+       [BT_CTF_VALUE_TYPE_REAL] =              NULL,
+       [BT_CTF_VALUE_TYPE_STRING] =    bt_ctf_value_string_destroy,
+       [BT_CTF_VALUE_TYPE_ARRAY] =             bt_ctf_value_array_destroy,
+       [BT_CTF_VALUE_TYPE_MAP] =               bt_ctf_value_map_destroy,
+};
+
+static
+struct bt_ctf_private_value *bt_ctf_value_null_copy(const struct bt_ctf_value *null_obj)
+{
+       return (void *) bt_ctf_value_null;
+}
+
+static
+struct bt_ctf_private_value *bt_ctf_value_bool_copy(const struct bt_ctf_value *bool_obj)
+{
+       return bt_ctf_private_value_bool_create_init(
+               BT_CTF_VALUE_TO_BOOL(bool_obj)->value);
+}
+
+static
+struct bt_ctf_private_value *bt_ctf_value_integer_copy(
+               const struct bt_ctf_value *integer_obj)
+{
+       return bt_ctf_private_value_integer_create_init(
+               BT_CTF_VALUE_TO_INTEGER(integer_obj)->value);
+}
+
+static
+struct bt_ctf_private_value *bt_ctf_value_real_copy(const struct bt_ctf_value *real_obj)
+{
+       return bt_ctf_private_value_real_create_init(
+               BT_CTF_VALUE_TO_REAL(real_obj)->value);
+}
+
+static
+struct bt_ctf_private_value *bt_ctf_value_string_copy(const struct bt_ctf_value *string_obj)
+{
+       return bt_ctf_private_value_string_create_init(
+               BT_CTF_VALUE_TO_STRING(string_obj)->gstr->str);
+}
+
+static
+struct bt_ctf_private_value *bt_ctf_value_array_copy(const struct bt_ctf_value *array_obj)
+{
+       int i;
+       int ret;
+       struct bt_ctf_private_value *copy_obj;
+       struct bt_ctf_value_array *typed_array_obj;
+
+       BT_LOGD("Copying array value: addr=%p", array_obj);
+       typed_array_obj = BT_CTF_VALUE_TO_ARRAY(array_obj);
+       copy_obj = bt_ctf_private_value_array_create();
+       if (!copy_obj) {
+               BT_LOGE_STR("Cannot create empty array value.");
+               goto end;
+       }
+
+       for (i = 0; i < typed_array_obj->garray->len; ++i) {
+               struct bt_ctf_private_value *element_obj_copy = NULL;
+               struct bt_ctf_value *element_obj =
+                       bt_ctf_value_array_borrow_element_by_index(
+                               array_obj, i);
+
+               BT_ASSERT(element_obj);
+               BT_LOGD("Copying array value's element: element-addr=%p, "
+                       "index=%d", element_obj, i);
+               ret = bt_ctf_value_copy(&element_obj_copy, element_obj);
+               if (ret) {
+                       BT_LOGE("Cannot copy array value's element: "
+                               "array-addr=%p, index=%d",
+                               array_obj, i);
+                       BT_CTF_OBJECT_PUT_REF_AND_RESET(copy_obj);
+                       goto end;
+               }
+
+               BT_ASSERT(element_obj_copy);
+               ret = bt_ctf_private_value_array_append_element(copy_obj,
+                       (void *) element_obj_copy);
+               BT_CTF_OBJECT_PUT_REF_AND_RESET(element_obj_copy);
+               if (ret) {
+                       BT_LOGE("Cannot append to array value: addr=%p",
+                               array_obj);
+                       BT_CTF_OBJECT_PUT_REF_AND_RESET(copy_obj);
+                       goto end;
+               }
+       }
+
+       BT_LOGD("Copied array value: original-addr=%p, copy-addr=%p",
+               array_obj, copy_obj);
+
+end:
+       return copy_obj;
+}
+
+static
+struct bt_ctf_private_value *bt_ctf_value_map_copy(const struct bt_ctf_value *map_obj)
+{
+       int ret;
+       GHashTableIter iter;
+       gpointer key, element_obj;
+       struct bt_ctf_private_value *copy_obj;
+       struct bt_ctf_private_value *element_obj_copy = NULL;
+       struct bt_ctf_value_map *typed_map_obj;
+
+       BT_LOGD("Copying map value: addr=%p", map_obj);
+       typed_map_obj = BT_CTF_VALUE_TO_MAP(map_obj);
+       copy_obj = bt_ctf_private_value_map_create();
+       if (!copy_obj) {
+               goto end;
+       }
+
+       g_hash_table_iter_init(&iter, typed_map_obj->ght);
+
+       while (g_hash_table_iter_next(&iter, &key, &element_obj)) {
+               const char *key_str = g_quark_to_string(GPOINTER_TO_UINT(key));
+
+               BT_ASSERT(key_str);
+               BT_LOGD("Copying map value's element: element-addr=%p, "
+                       "key=\"%s\"", element_obj, key_str);
+               ret = bt_ctf_value_copy(&element_obj_copy, element_obj);
+               if (ret) {
+                       BT_LOGE("Cannot copy map value's element: "
+                               "map-addr=%p, key=\"%s\"",
+                               map_obj, key_str);
+                       BT_CTF_OBJECT_PUT_REF_AND_RESET(copy_obj);
+                       goto end;
+               }
+
+               BT_ASSERT(element_obj_copy);
+               ret = bt_ctf_private_value_map_insert_entry(copy_obj, key_str,
+                       (void *) element_obj_copy);
+               BT_CTF_OBJECT_PUT_REF_AND_RESET(element_obj_copy);
+               if (ret) {
+                       BT_LOGE("Cannot insert into map value: addr=%p, key=\"%s\"",
+                               map_obj, key_str);
+                       BT_CTF_OBJECT_PUT_REF_AND_RESET(copy_obj);
+                       goto end;
+               }
+       }
+
+       BT_LOGD("Copied map value: addr=%p", map_obj);
+
+end:
+       return copy_obj;
+}
+
+static
+struct bt_ctf_private_value *(* const copy_funcs[])(const struct bt_ctf_value *) = {
+       [BT_CTF_VALUE_TYPE_NULL] =              bt_ctf_value_null_copy,
+       [BT_CTF_VALUE_TYPE_BOOL] =              bt_ctf_value_bool_copy,
+       [BT_CTF_VALUE_TYPE_INTEGER] =   bt_ctf_value_integer_copy,
+       [BT_CTF_VALUE_TYPE_REAL] =              bt_ctf_value_real_copy,
+       [BT_CTF_VALUE_TYPE_STRING] =    bt_ctf_value_string_copy,
+       [BT_CTF_VALUE_TYPE_ARRAY] =             bt_ctf_value_array_copy,
+       [BT_CTF_VALUE_TYPE_MAP] =               bt_ctf_value_map_copy,
+};
+
+static
+bt_bool bt_ctf_value_null_compare(const struct bt_ctf_value *object_a,
+               const struct bt_ctf_value *object_b)
+{
+       /*
+        * Always BT_TRUE since bt_ctf_value_compare() already checks if both
+        * object_a and object_b have the same type, and in the case of
+        * null value objects, they're always the same if it is so.
+        */
+       return BT_TRUE;
+}
+
+static
+bt_bool bt_ctf_value_bool_compare(const struct bt_ctf_value *object_a,
+               const struct bt_ctf_value *object_b)
+{
+       if (BT_CTF_VALUE_TO_BOOL(object_a)->value !=
+                       BT_CTF_VALUE_TO_BOOL(object_b)->value) {
+               BT_LOGV("Boolean value objects are different: "
+                       "bool-a-val=%d, bool-b-val=%d",
+                       BT_CTF_VALUE_TO_BOOL(object_a)->value,
+                       BT_CTF_VALUE_TO_BOOL(object_b)->value);
+               return BT_FALSE;
+       }
+
+       return BT_TRUE;
+}
+
+static
+bt_bool bt_ctf_value_integer_compare(const struct bt_ctf_value *object_a,
+               const struct bt_ctf_value *object_b)
+{
+       if (BT_CTF_VALUE_TO_INTEGER(object_a)->value !=
+                       BT_CTF_VALUE_TO_INTEGER(object_b)->value) {
+               BT_LOGV("Integer value objects are different: "
+                       "int-a-val=%" PRId64 ", int-b-val=%" PRId64,
+                       BT_CTF_VALUE_TO_INTEGER(object_a)->value,
+                       BT_CTF_VALUE_TO_INTEGER(object_b)->value);
+               return BT_FALSE;
+       }
+
+       return BT_TRUE;
+}
+
+static
+bt_bool bt_ctf_value_real_compare(const struct bt_ctf_value *object_a,
+               const struct bt_ctf_value *object_b)
+{
+       if (BT_CTF_VALUE_TO_REAL(object_a)->value !=
+                       BT_CTF_VALUE_TO_REAL(object_b)->value) {
+               BT_LOGV("Real number value objects are different: "
+                       "real-a-val=%f, real-b-val=%f",
+                       BT_CTF_VALUE_TO_REAL(object_a)->value,
+                       BT_CTF_VALUE_TO_REAL(object_b)->value);
+               return BT_FALSE;
+       }
+
+       return BT_TRUE;
+}
+
+static
+bt_bool bt_ctf_value_string_compare(const struct bt_ctf_value *object_a,
+               const struct bt_ctf_value *object_b)
+{
+       if (strcmp(BT_CTF_VALUE_TO_STRING(object_a)->gstr->str,
+                       BT_CTF_VALUE_TO_STRING(object_b)->gstr->str) != 0) {
+               BT_LOGV("String value objects are different: "
+                       "string-a-val=\"%s\", string-b-val=\"%s\"",
+                       BT_CTF_VALUE_TO_STRING(object_a)->gstr->str,
+                       BT_CTF_VALUE_TO_STRING(object_b)->gstr->str);
+               return BT_FALSE;
+       }
+
+       return BT_TRUE;
+}
+
+static
+bt_bool bt_ctf_value_array_compare(const struct bt_ctf_value *object_a,
+               const struct bt_ctf_value *object_b)
+{
+       int i;
+       bt_bool ret = BT_TRUE;
+       const struct bt_ctf_value_array *array_obj_a =
+               BT_CTF_VALUE_TO_ARRAY(object_a);
+
+       if (bt_ctf_value_array_get_size(object_a) !=
+                       bt_ctf_value_array_get_size(object_b)) {
+               BT_LOGV("Array values are different: size mismatch "
+                       "value-a-addr=%p, value-b-addr=%p, "
+                       "value-a-size=%" PRId64 ", value-b-size=%" PRId64,
+                       object_a, object_b,
+                       bt_ctf_value_array_get_size(object_a),
+                       bt_ctf_value_array_get_size(object_b));
+               ret = BT_FALSE;
+               goto end;
+       }
+
+       for (i = 0; i < array_obj_a->garray->len; ++i) {
+               struct bt_ctf_value *element_obj_a;
+               struct bt_ctf_value *element_obj_b;
+
+               element_obj_a = bt_ctf_value_array_borrow_element_by_index(
+                       object_a, i);
+               element_obj_b = bt_ctf_value_array_borrow_element_by_index(
+                       object_b, i);
+
+               if (!bt_ctf_value_compare(element_obj_a, element_obj_b)) {
+                       BT_LOGV("Array values's elements are different: "
+                               "value-a-addr=%p, value-b-addr=%p, index=%d",
+                               element_obj_a, element_obj_b, i);
+                       ret = BT_FALSE;
+                       goto end;
+               }
+       }
+
+end:
+       return ret;
+}
+
+static
+bt_bool bt_ctf_value_map_compare(const struct bt_ctf_value *object_a,
+               const struct bt_ctf_value *object_b)
+{
+       bt_bool ret = BT_TRUE;
+       GHashTableIter iter;
+       gpointer key, element_obj_a;
+       const struct bt_ctf_value_map *map_obj_a = BT_CTF_VALUE_TO_MAP(object_a);
+
+       if (bt_ctf_value_map_get_size(object_a) !=
+                       bt_ctf_value_map_get_size(object_b)) {
+               BT_LOGV("Map values are different: size mismatch "
+                       "value-a-addr=%p, value-b-addr=%p, "
+                       "value-a-size=%" PRId64 ", value-b-size=%" PRId64,
+                       object_a, object_b,
+                       bt_ctf_value_map_get_size(object_a),
+                       bt_ctf_value_map_get_size(object_b));
+               ret = BT_FALSE;
+               goto end;
+       }
+
+       g_hash_table_iter_init(&iter, map_obj_a->ght);
+
+       while (g_hash_table_iter_next(&iter, &key, &element_obj_a)) {
+               struct bt_ctf_value *element_obj_b;
+               const char *key_str = g_quark_to_string(GPOINTER_TO_UINT(key));
+
+               element_obj_b = bt_ctf_value_map_borrow_entry_value(object_b,
+                       key_str);
+
+               if (!bt_ctf_value_compare(element_obj_a, element_obj_b)) {
+                       BT_LOGV("Map values's elements are different: "
+                               "value-a-addr=%p, value-b-addr=%p, key=\"%s\"",
+                               element_obj_a, element_obj_b, key_str);
+                       ret = BT_FALSE;
+                       goto end;
+               }
+       }
+
+end:
+       return ret;
+}
+
+static
+bt_bool (* const compare_funcs[])(const struct bt_ctf_value *,
+               const struct bt_ctf_value *) = {
+       [BT_CTF_VALUE_TYPE_NULL] =              bt_ctf_value_null_compare,
+       [BT_CTF_VALUE_TYPE_BOOL] =              bt_ctf_value_bool_compare,
+       [BT_CTF_VALUE_TYPE_INTEGER] =   bt_ctf_value_integer_compare,
+       [BT_CTF_VALUE_TYPE_REAL] =              bt_ctf_value_real_compare,
+       [BT_CTF_VALUE_TYPE_STRING] =    bt_ctf_value_string_compare,
+       [BT_CTF_VALUE_TYPE_ARRAY] =             bt_ctf_value_array_compare,
+       [BT_CTF_VALUE_TYPE_MAP] =               bt_ctf_value_map_compare,
+};
+
+static
+void bt_ctf_value_null_freeze(struct bt_ctf_value *object)
+{
+}
+
+static
+void bt_ctf_value_generic_freeze(struct bt_ctf_value *object)
+{
+       object->frozen = BT_TRUE;
+}
+
+static
+void bt_ctf_value_array_freeze(struct bt_ctf_value *object)
+{
+       int i;
+       struct bt_ctf_value_array *typed_array_obj =
+               BT_CTF_VALUE_TO_ARRAY(object);
+
+       for (i = 0; i < typed_array_obj->garray->len; ++i) {
+               bt_ctf_value_freeze(g_ptr_array_index(typed_array_obj->garray, i));
+       }
+
+       bt_ctf_value_generic_freeze(object);
+}
+
+static
+void bt_ctf_value_map_freeze(struct bt_ctf_value *object)
+{
+       GHashTableIter iter;
+       gpointer key, element_obj;
+       const struct bt_ctf_value_map *map_obj = BT_CTF_VALUE_TO_MAP(object);
+
+       g_hash_table_iter_init(&iter, map_obj->ght);
+
+       while (g_hash_table_iter_next(&iter, &key, &element_obj)) {
+               bt_ctf_value_freeze(element_obj);
+       }
+
+       bt_ctf_value_generic_freeze(object);
+}
+
+static
+void (* const freeze_funcs[])(struct bt_ctf_value *) = {
+       [BT_CTF_VALUE_TYPE_NULL] =              bt_ctf_value_null_freeze,
+       [BT_CTF_VALUE_TYPE_BOOL] =              bt_ctf_value_generic_freeze,
+       [BT_CTF_VALUE_TYPE_INTEGER] =   bt_ctf_value_generic_freeze,
+       [BT_CTF_VALUE_TYPE_REAL] =              bt_ctf_value_generic_freeze,
+       [BT_CTF_VALUE_TYPE_STRING] =    bt_ctf_value_generic_freeze,
+       [BT_CTF_VALUE_TYPE_ARRAY] =             bt_ctf_value_array_freeze,
+       [BT_CTF_VALUE_TYPE_MAP] =               bt_ctf_value_map_freeze,
+};
+
+static
+void bt_ctf_value_destroy(struct bt_ctf_object *obj)
+{
+       struct bt_ctf_value *value;
+
+       value = container_of(obj, struct bt_ctf_value, base);
+       BT_LOGD("Destroying value: addr=%p", value);
+
+       if (bt_ctf_value_is_null(value)) {
+               BT_LOGD_STR("Not destroying the null value singleton.");
+               return;
+       }
+
+       if (destroy_funcs[value->type]) {
+               destroy_funcs[value->type](value);
+       }
+
+       g_free(value);
+}
+
+BT_HIDDEN
+enum bt_ctf_value_status _bt_ctf_value_freeze(struct bt_ctf_value *object)
+{
+       enum bt_ctf_value_status ret = BT_CTF_VALUE_STATUS_OK;
+
+       BT_ASSERT(object);
+
+       if (object->frozen) {
+               goto end;
+       }
+
+       BT_LOGD("Freezing value: addr=%p", object);
+       freeze_funcs[object->type](object);
+
+end:
+       return ret;
+}
+
+BT_HIDDEN
+enum bt_ctf_value_type bt_ctf_value_get_type(const struct bt_ctf_value *object)
+{
+       BT_ASSERT_PRE_NON_NULL(object, "Value object");
+       return object->type;
+}
+
+static
+struct bt_ctf_value bt_ctf_value_create_base(enum bt_ctf_value_type type)
+{
+       struct bt_ctf_value value;
+
+       value.type = type;
+       value.frozen = BT_FALSE;
+       bt_ctf_object_init_shared(&value.base, bt_ctf_value_destroy);
+       return value;
+}
+
+BT_HIDDEN
+struct bt_ctf_private_value *bt_ctf_private_value_bool_create_init(bt_bool val)
+{
+       struct bt_ctf_value_bool *bool_obj;
+
+       BT_LOGD("Creating boolean value object: val=%d", val);
+       bool_obj = g_new0(struct bt_ctf_value_bool, 1);
+       if (!bool_obj) {
+               BT_LOGE_STR("Failed to allocate one boolean value object.");
+               goto end;
+       }
+
+       bool_obj->base = bt_ctf_value_create_base(BT_CTF_VALUE_TYPE_BOOL);
+       bool_obj->value = val;
+       BT_LOGD("Created boolean value object: addr=%p", bool_obj);
+
+end:
+       return (void *) BT_CTF_VALUE_FROM_CONCRETE(bool_obj);
+}
+
+BT_HIDDEN
+struct bt_ctf_private_value *bt_ctf_private_value_bool_create(void)
+{
+       return bt_ctf_private_value_bool_create_init(BT_FALSE);
+}
+
+BT_HIDDEN
+struct bt_ctf_private_value *bt_ctf_private_value_integer_create_init(int64_t val)
+{
+       struct bt_ctf_value_integer *integer_obj;
+
+       BT_LOGD("Creating integer value object: val=%" PRId64, val);
+       integer_obj = g_new0(struct bt_ctf_value_integer, 1);
+       if (!integer_obj) {
+               BT_LOGE_STR("Failed to allocate one integer value object.");
+               goto end;
+       }
+
+       integer_obj->base = bt_ctf_value_create_base(BT_CTF_VALUE_TYPE_INTEGER);
+       integer_obj->value = val;
+       BT_LOGD("Created integer value object: addr=%p",
+               integer_obj);
+
+end:
+       return (void *) BT_CTF_VALUE_FROM_CONCRETE(integer_obj);
+}
+
+BT_HIDDEN
+struct bt_ctf_private_value *bt_ctf_private_value_integer_create(void)
+{
+       return bt_ctf_private_value_integer_create_init(0);
+}
+
+BT_HIDDEN
+struct bt_ctf_private_value *bt_ctf_private_value_real_create_init(double val)
+{
+       struct bt_ctf_value_real *real_obj;
+
+       BT_LOGD("Creating real number value object: val=%f", val);
+       real_obj = g_new0(struct bt_ctf_value_real, 1);
+       if (!real_obj) {
+               BT_LOGE_STR("Failed to allocate one real number value object.");
+               goto end;
+       }
+
+       real_obj->base = bt_ctf_value_create_base(BT_CTF_VALUE_TYPE_REAL);
+       real_obj->value = val;
+       BT_LOGD("Created real number value object: addr=%p",
+               real_obj);
+
+end:
+       return (void *) BT_CTF_VALUE_FROM_CONCRETE(real_obj);
+}
+
+BT_HIDDEN
+struct bt_ctf_private_value *bt_ctf_private_value_real_create(void)
+{
+       return bt_ctf_private_value_real_create_init(0.);
+}
+
+BT_HIDDEN
+struct bt_ctf_private_value *bt_ctf_private_value_string_create_init(const char *val)
+{
+       struct bt_ctf_value_string *string_obj = NULL;
+
+       if (!val) {
+               BT_LOGW_STR("Invalid parameter: value is NULL.");
+               goto end;
+       }
+
+       BT_LOGD("Creating string value object: val-len=%zu", strlen(val));
+       string_obj = g_new0(struct bt_ctf_value_string, 1);
+       if (!string_obj) {
+               BT_LOGE_STR("Failed to allocate one string object.");
+               goto end;
+       }
+
+       string_obj->base = bt_ctf_value_create_base(BT_CTF_VALUE_TYPE_STRING);
+       string_obj->gstr = g_string_new(val);
+       if (!string_obj->gstr) {
+               BT_LOGE_STR("Failed to allocate a GString.");
+               g_free(string_obj);
+               string_obj = NULL;
+               goto end;
+       }
+
+       BT_LOGD("Created string value object: addr=%p",
+               string_obj);
+
+end:
+       return (void *) BT_CTF_VALUE_FROM_CONCRETE(string_obj);
+}
+
+BT_HIDDEN
+struct bt_ctf_private_value *bt_ctf_private_value_string_create(void)
+{
+       return bt_ctf_private_value_string_create_init("");
+}
+
+BT_HIDDEN
+struct bt_ctf_private_value *bt_ctf_private_value_array_create(void)
+{
+       struct bt_ctf_value_array *array_obj;
+
+       BT_LOGD_STR("Creating empty array value object.");
+       array_obj = g_new0(struct bt_ctf_value_array, 1);
+       if (!array_obj) {
+               BT_LOGE_STR("Failed to allocate one array object.");
+               goto end;
+       }
+
+       array_obj->base = bt_ctf_value_create_base(BT_CTF_VALUE_TYPE_ARRAY);
+       array_obj->garray = bt_g_ptr_array_new_full(0,
+               (GDestroyNotify) bt_ctf_object_put_ref);
+       if (!array_obj->garray) {
+               BT_LOGE_STR("Failed to allocate a GPtrArray.");
+               g_free(array_obj);
+               array_obj = NULL;
+               goto end;
+       }
+
+       BT_LOGD("Created array value object: addr=%p",
+               array_obj);
+
+end:
+       return (void *) BT_CTF_VALUE_FROM_CONCRETE(array_obj);
+}
+
+BT_HIDDEN
+struct bt_ctf_private_value *bt_ctf_private_value_map_create(void)
+{
+       struct bt_ctf_value_map *map_obj;
+
+       BT_LOGD_STR("Creating empty map value object.");
+       map_obj = g_new0(struct bt_ctf_value_map, 1);
+       if (!map_obj) {
+               BT_LOGE_STR("Failed to allocate one map object.");
+               goto end;
+       }
+
+       map_obj->base = bt_ctf_value_create_base(BT_CTF_VALUE_TYPE_MAP);
+       map_obj->ght = g_hash_table_new_full(g_direct_hash, g_direct_equal,
+               NULL, (GDestroyNotify) bt_ctf_object_put_ref);
+       if (!map_obj->ght) {
+               BT_LOGE_STR("Failed to allocate a GHashTable.");
+               g_free(map_obj);
+               map_obj = NULL;
+               goto end;
+       }
+
+       BT_LOGD("Created map value object: addr=%p",
+               map_obj);
+
+end:
+       return (void *) BT_CTF_VALUE_FROM_CONCRETE(map_obj);
+}
+
+BT_HIDDEN
+bt_bool bt_ctf_value_bool_get(const struct bt_ctf_value *bool_obj)
+{
+       BT_ASSERT_PRE_NON_NULL(bool_obj, "Value object");
+       BT_ASSERT_PRE_VALUE_IS_TYPE(bool_obj, BT_CTF_VALUE_TYPE_BOOL);
+       return BT_CTF_VALUE_TO_BOOL(bool_obj)->value;
+}
+
+BT_HIDDEN
+void bt_ctf_private_value_bool_set(struct bt_ctf_private_value *bool_obj, bt_bool val)
+{
+       BT_ASSERT_PRE_NON_NULL(bool_obj, "Value object");
+       BT_ASSERT_PRE_VALUE_IS_TYPE(bool_obj, BT_CTF_VALUE_TYPE_BOOL);
+       BT_ASSERT_PRE_VALUE_HOT(bool_obj, "Value object");
+       BT_CTF_VALUE_TO_BOOL(bool_obj)->value = val;
+       BT_LOGV("Set boolean value's raw value: value-addr=%p, value=%d",
+               bool_obj, val);
+}
+
+BT_HIDDEN
+int64_t bt_ctf_value_integer_get(const struct bt_ctf_value *integer_obj)
+{
+       BT_ASSERT_PRE_NON_NULL(integer_obj, "Value object");
+       BT_ASSERT_PRE_VALUE_IS_TYPE(integer_obj, BT_CTF_VALUE_TYPE_INTEGER);
+       return BT_CTF_VALUE_TO_INTEGER(integer_obj)->value;
+}
+
+BT_HIDDEN
+void bt_ctf_private_value_integer_set(struct bt_ctf_private_value *integer_obj,
+               int64_t val)
+{
+       BT_ASSERT_PRE_NON_NULL(integer_obj, "Value object");
+       BT_ASSERT_PRE_VALUE_IS_TYPE(integer_obj, BT_CTF_VALUE_TYPE_INTEGER);
+       BT_ASSERT_PRE_VALUE_HOT(integer_obj, "Value object");
+       BT_CTF_VALUE_TO_INTEGER(integer_obj)->value = val;
+       BT_LOGV("Set integer value's raw value: value-addr=%p, value=%" PRId64,
+               integer_obj, val);
+}
+
+BT_HIDDEN
+double bt_ctf_value_real_get(const struct bt_ctf_value *real_obj)
+{
+       BT_ASSERT_PRE_NON_NULL(real_obj, "Value object");
+       BT_ASSERT_PRE_VALUE_IS_TYPE(real_obj, BT_CTF_VALUE_TYPE_REAL);
+       return BT_CTF_VALUE_TO_REAL(real_obj)->value;
+}
+
+BT_HIDDEN
+void bt_ctf_private_value_real_set(struct bt_ctf_private_value *real_obj, double val)
+{
+       BT_ASSERT_PRE_NON_NULL(real_obj, "Value object");
+       BT_ASSERT_PRE_VALUE_IS_TYPE(real_obj, BT_CTF_VALUE_TYPE_REAL);
+       BT_ASSERT_PRE_VALUE_HOT(real_obj, "Value object");
+       BT_CTF_VALUE_TO_REAL(real_obj)->value = val;
+       BT_LOGV("Set real number value's raw value: value-addr=%p, value=%f",
+               real_obj, val);
+}
+
+BT_HIDDEN
+const char *bt_ctf_value_string_get(const struct bt_ctf_value *string_obj)
+{
+       BT_ASSERT_PRE_NON_NULL(string_obj, "Value object");
+       BT_ASSERT_PRE_VALUE_IS_TYPE(string_obj, BT_CTF_VALUE_TYPE_STRING);
+       return BT_CTF_VALUE_TO_STRING(string_obj)->gstr->str;
+}
+
+BT_HIDDEN
+enum bt_ctf_value_status bt_ctf_private_value_string_set(
+               struct bt_ctf_private_value *string_obj, const char *val)
+{
+       BT_ASSERT_PRE_NON_NULL(string_obj, "Value object");
+       BT_ASSERT_PRE_VALUE_IS_TYPE(string_obj, BT_CTF_VALUE_TYPE_STRING);
+       BT_ASSERT_PRE_VALUE_HOT(string_obj, "Value object");
+       g_string_assign(BT_CTF_VALUE_TO_STRING(string_obj)->gstr, val);
+       BT_LOGV("Set string value's raw value: value-addr=%p, raw-value-addr=%p",
+               string_obj, val);
+       return BT_CTF_VALUE_STATUS_OK;
+}
+
+BT_HIDDEN
+uint64_t bt_ctf_value_array_get_size(const struct bt_ctf_value *array_obj)
+{
+       BT_ASSERT_PRE_NON_NULL(array_obj, "Value object");
+       BT_ASSERT_PRE_VALUE_IS_TYPE(array_obj, BT_CTF_VALUE_TYPE_ARRAY);
+       return (uint64_t) BT_CTF_VALUE_TO_ARRAY(array_obj)->garray->len;
+}
+
+BT_HIDDEN
+struct bt_ctf_value *bt_ctf_value_array_borrow_element_by_index(
+               const struct bt_ctf_value *array_obj,
+               uint64_t index)
+{
+       struct bt_ctf_value_array *typed_array_obj =
+               BT_CTF_VALUE_TO_ARRAY(array_obj);
+
+       BT_ASSERT_PRE_NON_NULL(array_obj, "Value object");
+       BT_ASSERT_PRE_VALUE_IS_TYPE(array_obj, BT_CTF_VALUE_TYPE_ARRAY);
+       BT_ASSERT_PRE_VALUE_INDEX_IN_BOUNDS(index,
+               typed_array_obj->garray->len);
+       return g_ptr_array_index(typed_array_obj->garray, index);
+}
+
+BT_HIDDEN
+struct bt_ctf_private_value *bt_ctf_private_value_array_borrow_element_by_index(
+               const struct bt_ctf_private_value *array_obj,
+               uint64_t index)
+{
+       return (void *) bt_ctf_value_array_borrow_element_by_index(
+               (void *) array_obj, index);
+}
+
+BT_HIDDEN
+enum bt_ctf_value_status bt_ctf_private_value_array_append_element(
+               struct bt_ctf_private_value *array_obj,
+               struct bt_ctf_value *element_obj)
+{
+       struct bt_ctf_value_array *typed_array_obj =
+               BT_CTF_VALUE_TO_ARRAY(array_obj);
+
+       BT_ASSERT_PRE_NON_NULL(array_obj, "Array value object");
+       BT_ASSERT_PRE_NON_NULL(element_obj, "Element value object");
+       BT_ASSERT_PRE_VALUE_IS_TYPE(array_obj, BT_CTF_VALUE_TYPE_ARRAY);
+       BT_ASSERT_PRE_VALUE_HOT(array_obj, "Array value object");
+       g_ptr_array_add(typed_array_obj->garray, element_obj);
+       bt_ctf_object_get_ref(element_obj);
+       BT_LOGV("Appended element to array value: array-value-addr=%p, "
+               "element-value-addr=%p, new-size=%u",
+               array_obj, element_obj, typed_array_obj->garray->len);
+       return BT_CTF_VALUE_STATUS_OK;
+}
+
+BT_HIDDEN
+enum bt_ctf_value_status bt_ctf_private_value_array_append_bool_element(
+               struct bt_ctf_private_value *array_obj, bt_bool val)
+{
+       enum bt_ctf_value_status ret;
+       struct bt_ctf_private_value *bool_obj = NULL;
+
+       bool_obj = bt_ctf_private_value_bool_create_init(val);
+       ret = bt_ctf_private_value_array_append_element(array_obj,
+               (void *) bool_obj);
+       bt_ctf_object_put_ref(bool_obj);
+       return ret;
+}
+
+BT_HIDDEN
+enum bt_ctf_value_status bt_ctf_private_value_array_append_integer_element(
+               struct bt_ctf_private_value *array_obj, int64_t val)
+{
+       enum bt_ctf_value_status ret;
+       struct bt_ctf_private_value *integer_obj = NULL;
+
+       integer_obj = bt_ctf_private_value_integer_create_init(val);
+       ret = bt_ctf_private_value_array_append_element(array_obj,
+               (void *) integer_obj);
+       bt_ctf_object_put_ref(integer_obj);
+       return ret;
+}
+
+BT_HIDDEN
+enum bt_ctf_value_status bt_ctf_private_value_array_append_real_element(
+               struct bt_ctf_private_value *array_obj, double val)
+{
+       enum bt_ctf_value_status ret;
+       struct bt_ctf_private_value *real_obj = NULL;
+
+       real_obj = bt_ctf_private_value_real_create_init(val);
+       ret = bt_ctf_private_value_array_append_element(array_obj,
+               (void *) real_obj);
+       bt_ctf_object_put_ref(real_obj);
+       return ret;
+}
+
+BT_HIDDEN
+enum bt_ctf_value_status bt_ctf_private_value_array_append_string_element(
+               struct bt_ctf_private_value *array_obj, const char *val)
+{
+       enum bt_ctf_value_status ret;
+       struct bt_ctf_private_value *string_obj = NULL;
+
+       string_obj = bt_ctf_private_value_string_create_init(val);
+       ret = bt_ctf_private_value_array_append_element(array_obj,
+               (void *) string_obj);
+       bt_ctf_object_put_ref(string_obj);
+       return ret;
+}
+
+BT_HIDDEN
+enum bt_ctf_value_status bt_ctf_private_value_array_append_empty_array_element(
+               struct bt_ctf_private_value *array_obj)
+{
+       enum bt_ctf_value_status ret;
+       struct bt_ctf_private_value *empty_array_obj = NULL;
+
+       empty_array_obj = bt_ctf_private_value_array_create();
+       ret = bt_ctf_private_value_array_append_element(array_obj,
+               (void *) empty_array_obj);
+       bt_ctf_object_put_ref(empty_array_obj);
+       return ret;
+}
+
+BT_HIDDEN
+enum bt_ctf_value_status bt_ctf_private_value_array_append_empty_map_element(
+               struct bt_ctf_private_value *array_obj)
+{
+       enum bt_ctf_value_status ret;
+       struct bt_ctf_private_value *map_obj = NULL;
+
+       map_obj = bt_ctf_private_value_map_create();
+       ret = bt_ctf_private_value_array_append_element(array_obj,
+               (void *) map_obj);
+       bt_ctf_object_put_ref(map_obj);
+       return ret;
+}
+
+BT_HIDDEN
+enum bt_ctf_value_status bt_ctf_private_value_array_set_element_by_index(
+               struct bt_ctf_private_value *array_obj, uint64_t index,
+               struct bt_ctf_value *element_obj)
+{
+       struct bt_ctf_value_array *typed_array_obj =
+               BT_CTF_VALUE_TO_ARRAY(array_obj);
+
+       BT_ASSERT_PRE_NON_NULL(array_obj, "Array value object");
+       BT_ASSERT_PRE_NON_NULL(element_obj, "Element value object");
+       BT_ASSERT_PRE_VALUE_IS_TYPE(array_obj, BT_CTF_VALUE_TYPE_ARRAY);
+       BT_ASSERT_PRE_VALUE_HOT(array_obj, "Array value object");
+       BT_ASSERT_PRE_VALUE_INDEX_IN_BOUNDS(index,
+               typed_array_obj->garray->len);
+       bt_ctf_object_put_ref(g_ptr_array_index(typed_array_obj->garray, index));
+       g_ptr_array_index(typed_array_obj->garray, index) = element_obj;
+       bt_ctf_object_get_ref(element_obj);
+       BT_LOGV("Set array value's element: array-value-addr=%p, "
+               "index=%" PRIu64 ", element-value-addr=%p",
+               array_obj, index, element_obj);
+       return BT_CTF_VALUE_STATUS_OK;
+}
+
+BT_HIDDEN
+uint64_t bt_ctf_value_map_get_size(const struct bt_ctf_value *map_obj)
+{
+       BT_ASSERT_PRE_NON_NULL(map_obj, "Value object");
+       BT_ASSERT_PRE_VALUE_IS_TYPE(map_obj, BT_CTF_VALUE_TYPE_MAP);
+       return (uint64_t) g_hash_table_size(BT_CTF_VALUE_TO_MAP(map_obj)->ght);
+}
+
+BT_HIDDEN
+struct bt_ctf_value *bt_ctf_value_map_borrow_entry_value(const struct bt_ctf_value *map_obj,
+               const char *key)
+{
+       BT_ASSERT_PRE_NON_NULL(map_obj, "Value object");
+       BT_ASSERT_PRE_NON_NULL(key, "Key");
+       BT_ASSERT_PRE_VALUE_IS_TYPE(map_obj, BT_CTF_VALUE_TYPE_MAP);
+       return g_hash_table_lookup(BT_CTF_VALUE_TO_MAP(map_obj)->ght,
+               GUINT_TO_POINTER(g_quark_from_string(key)));
+}
+
+BT_HIDDEN
+struct bt_ctf_private_value *bt_ctf_private_value_map_borrow_entry_value(
+               const struct bt_ctf_private_value *map_obj, const char *key)
+{
+       return (void *) bt_ctf_value_map_borrow_entry_value((void *) map_obj, key);
+}
+
+BT_HIDDEN
+bt_bool bt_ctf_value_map_has_entry(const struct bt_ctf_value *map_obj, const char *key)
+{
+       BT_ASSERT_PRE_NON_NULL(map_obj, "Value object");
+       BT_ASSERT_PRE_NON_NULL(key, "Key");
+       BT_ASSERT_PRE_VALUE_IS_TYPE(map_obj, BT_CTF_VALUE_TYPE_MAP);
+       return bt_g_hash_table_contains(BT_CTF_VALUE_TO_MAP(map_obj)->ght,
+               GUINT_TO_POINTER(g_quark_from_string(key)));
+}
+
+BT_HIDDEN
+enum bt_ctf_value_status bt_ctf_private_value_map_insert_entry(
+               struct bt_ctf_private_value *map_obj,
+               const char *key, struct bt_ctf_value *element_obj)
+{
+       BT_ASSERT_PRE_NON_NULL(map_obj, "Map value object");
+       BT_ASSERT_PRE_NON_NULL(key, "Key");
+       BT_ASSERT_PRE_NON_NULL(element_obj, "Element value object");
+       BT_ASSERT_PRE_VALUE_IS_TYPE(map_obj, BT_CTF_VALUE_TYPE_MAP);
+       BT_ASSERT_PRE_VALUE_HOT(map_obj, "Map value object");
+       g_hash_table_insert(BT_CTF_VALUE_TO_MAP(map_obj)->ght,
+               GUINT_TO_POINTER(g_quark_from_string(key)), element_obj);
+       bt_ctf_object_get_ref(element_obj);
+       BT_LOGV("Inserted value into map value: map-value-addr=%p, "
+               "key=\"%s\", element-value-addr=%p",
+               map_obj, key, element_obj);
+       return BT_CTF_VALUE_STATUS_OK;
+}
+
+BT_HIDDEN
+enum bt_ctf_value_status bt_ctf_private_value_map_insert_bool_entry(
+               struct bt_ctf_private_value *map_obj, const char *key, bt_bool val)
+{
+       enum bt_ctf_value_status ret;
+       struct bt_ctf_private_value *bool_obj = NULL;
+
+       bool_obj = bt_ctf_private_value_bool_create_init(val);
+       ret = bt_ctf_private_value_map_insert_entry(map_obj, key,
+               (void *) bool_obj);
+       bt_ctf_object_put_ref(bool_obj);
+       return ret;
+}
+
+BT_HIDDEN
+enum bt_ctf_value_status bt_ctf_private_value_map_insert_integer_entry(
+               struct bt_ctf_private_value *map_obj, const char *key, int64_t val)
+{
+       enum bt_ctf_value_status ret;
+       struct bt_ctf_private_value *integer_obj = NULL;
+
+       integer_obj = bt_ctf_private_value_integer_create_init(val);
+       ret = bt_ctf_private_value_map_insert_entry(map_obj, key,
+               (void *) integer_obj);
+       bt_ctf_object_put_ref(integer_obj);
+       return ret;
+}
+
+BT_HIDDEN
+enum bt_ctf_value_status bt_ctf_private_value_map_insert_real_entry(
+               struct bt_ctf_private_value *map_obj, const char *key, double val)
+{
+       enum bt_ctf_value_status ret;
+       struct bt_ctf_private_value *real_obj = NULL;
+
+       real_obj = bt_ctf_private_value_real_create_init(val);
+       ret = bt_ctf_private_value_map_insert_entry(map_obj, key,
+               (void *) real_obj);
+       bt_ctf_object_put_ref(real_obj);
+       return ret;
+}
+
+BT_HIDDEN
+enum bt_ctf_value_status bt_ctf_private_value_map_insert_string_entry(
+               struct bt_ctf_private_value *map_obj, const char *key,
+               const char *val)
+{
+       enum bt_ctf_value_status ret;
+       struct bt_ctf_private_value *string_obj = NULL;
+
+       string_obj = bt_ctf_private_value_string_create_init(val);
+       ret = bt_ctf_private_value_map_insert_entry(map_obj, key,
+               (void *) string_obj);
+       bt_ctf_object_put_ref(string_obj);
+       return ret;
+}
+
+BT_HIDDEN
+enum bt_ctf_value_status bt_ctf_private_value_map_insert_empty_array_entry(
+               struct bt_ctf_private_value *map_obj, const char *key)
+{
+       enum bt_ctf_value_status ret;
+       struct bt_ctf_private_value *array_obj = NULL;
+
+       array_obj = bt_ctf_private_value_array_create();
+       ret = bt_ctf_private_value_map_insert_entry(map_obj, key,
+               (void *) array_obj);
+       bt_ctf_object_put_ref(array_obj);
+       return ret;
+}
+
+BT_HIDDEN
+enum bt_ctf_value_status bt_ctf_private_value_map_insert_empty_map_entry(
+               struct bt_ctf_private_value *map_obj, const char *key)
+{
+       enum bt_ctf_value_status ret;
+       struct bt_ctf_private_value *empty_map_obj = NULL;
+
+       empty_map_obj = bt_ctf_private_value_map_create();
+       ret = bt_ctf_private_value_map_insert_entry(map_obj, key,
+               (void *) empty_map_obj);
+       bt_ctf_object_put_ref(empty_map_obj);
+       return ret;
+}
+
+BT_HIDDEN
+enum bt_ctf_value_status bt_ctf_value_map_foreach_entry(const struct bt_ctf_value *map_obj,
+               bt_ctf_value_map_foreach_entry_cb cb, void *data)
+{
+       enum bt_ctf_value_status ret = BT_CTF_VALUE_STATUS_OK;
+       gpointer key, element_obj;
+       GHashTableIter iter;
+       struct bt_ctf_value_map *typed_map_obj = BT_CTF_VALUE_TO_MAP(map_obj);
+
+       BT_ASSERT_PRE_NON_NULL(map_obj, "Value object");
+       BT_ASSERT_PRE_NON_NULL(cb, "Callback");
+       BT_ASSERT_PRE_VALUE_IS_TYPE(map_obj, BT_CTF_VALUE_TYPE_MAP);
+       g_hash_table_iter_init(&iter, typed_map_obj->ght);
+
+       while (g_hash_table_iter_next(&iter, &key, &element_obj)) {
+               const char *key_str = g_quark_to_string(GPOINTER_TO_UINT(key));
+
+               if (!cb(key_str, element_obj, data)) {
+                       BT_LOGV("User canceled the loop: key=\"%s\", "
+                               "value-addr=%p, data=%p",
+                               key_str, element_obj, data);
+                       ret = BT_CTF_VALUE_STATUS_CANCELED;
+                       break;
+               }
+       }
+
+       return ret;
+}
+
+BT_HIDDEN
+enum bt_ctf_value_status bt_ctf_private_value_map_foreach_entry(
+               const struct bt_ctf_private_value *map_obj,
+               bt_ctf_private_value_map_foreach_entry_cb cb, void *data)
+{
+       return bt_ctf_value_map_foreach_entry((void *) map_obj,
+               (bt_ctf_value_map_foreach_entry_cb) cb, data);
+}
+
+struct extend_map_element_data {
+       struct bt_ctf_private_value *extended_obj;
+       enum bt_ctf_value_status status;
+};
+
+static
+bt_bool extend_map_element(const char *key,
+               struct bt_ctf_value *extension_obj_elem, void *data)
+{
+       bt_bool ret = BT_TRUE;
+       struct extend_map_element_data *extend_data = data;
+       struct bt_ctf_private_value *extension_obj_elem_copy = NULL;
+
+       /* Copy object which is to replace the current one */
+       extend_data->status = bt_ctf_value_copy(&extension_obj_elem_copy,
+               extension_obj_elem);
+       if (extend_data->status) {
+               BT_LOGE("Cannot copy map element: addr=%p",
+                       extension_obj_elem);
+               goto error;
+       }
+
+       BT_ASSERT(extension_obj_elem_copy);
+
+       /* Replace in extended object */
+       extend_data->status = bt_ctf_private_value_map_insert_entry(
+               extend_data->extended_obj, key,
+               (void *) extension_obj_elem_copy);
+       if (extend_data->status) {
+               BT_LOGE("Cannot replace value in extended value: key=\"%s\", "
+                       "extended-value-addr=%p, element-value-addr=%p",
+                       key, extend_data->extended_obj,
+                       extension_obj_elem_copy);
+               goto error;
+       }
+
+       goto end;
+
+error:
+       BT_ASSERT(extend_data->status != BT_CTF_VALUE_STATUS_OK);
+       ret = BT_FALSE;
+
+end:
+       BT_CTF_OBJECT_PUT_REF_AND_RESET(extension_obj_elem_copy);
+       return ret;
+}
+
+BT_HIDDEN
+enum bt_ctf_value_status bt_ctf_value_map_extend(
+               struct bt_ctf_private_value **extended_map_obj,
+               const struct bt_ctf_value *base_map_obj,
+               const struct bt_ctf_value *extension_obj)
+{
+       struct extend_map_element_data extend_data = {
+               .extended_obj = NULL,
+               .status = BT_CTF_VALUE_STATUS_OK,
+       };
+
+       BT_ASSERT_PRE_NON_NULL(base_map_obj, "Base value object");
+       BT_ASSERT_PRE_NON_NULL(extension_obj, "Extension value object");
+       BT_ASSERT_PRE_NON_NULL(extended_map_obj,
+               "Extended value object (output)");
+       BT_ASSERT_PRE_VALUE_IS_TYPE(base_map_obj, BT_CTF_VALUE_TYPE_MAP);
+       BT_ASSERT_PRE_VALUE_IS_TYPE(extension_obj, BT_CTF_VALUE_TYPE_MAP);
+       BT_LOGD("Extending map value: base-value-addr=%p, extension-value-addr=%p",
+               base_map_obj, extension_obj);
+       *extended_map_obj = NULL;
+
+       /* Create copy of base map object to start with */
+       extend_data.status = bt_ctf_value_copy(extended_map_obj, base_map_obj);
+       if (extend_data.status) {
+               BT_LOGE("Cannot copy base value: base-value-addr=%p",
+                       base_map_obj);
+               goto error;
+       }
+
+       BT_ASSERT(extended_map_obj);
+
+       /*
+        * For each key in the extension map object, replace this key
+        * in the copied map object.
+        */
+       extend_data.extended_obj = *extended_map_obj;
+
+       if (bt_ctf_value_map_foreach_entry(extension_obj, extend_map_element,
+                       &extend_data)) {
+               BT_LOGE("Cannot iterate on the extension object's elements: "
+                       "extension-value-addr=%p", extension_obj);
+               goto error;
+       }
+
+       if (extend_data.status) {
+               BT_LOGE("Failed to successfully iterate on the extension object's elements: "
+                       "extension-value-addr=%p", extension_obj);
+               goto error;
+       }
+
+       BT_LOGD("Extended map value: extended-value-addr=%p",
+               *extended_map_obj);
+       goto end;
+
+error:
+       BT_CTF_OBJECT_PUT_REF_AND_RESET(*extended_map_obj);
+       *extended_map_obj = NULL;
+
+end:
+       return extend_data.status;
+}
+
+BT_HIDDEN
+enum bt_ctf_value_status bt_ctf_value_copy(struct bt_ctf_private_value **copy_obj,
+               const struct bt_ctf_value *object)
+{
+       enum bt_ctf_value_status status = BT_CTF_VALUE_STATUS_OK;
+
+       BT_ASSERT_PRE_NON_NULL(object, "Value object");
+       BT_ASSERT_PRE_NON_NULL(copy_obj, "Value object copy (output)");
+       BT_LOGD("Copying value object: addr=%p", object);
+       *copy_obj = copy_funcs[object->type](object);
+       if (*copy_obj) {
+               BT_LOGD("Copied value object: copy-value-addr=%p",
+                       copy_obj);
+       } else {
+               status = BT_CTF_VALUE_STATUS_NOMEM;
+               *copy_obj = NULL;
+               BT_LOGE_STR("Failed to copy value object.");
+       }
+
+       return status;
+}
+
+BT_HIDDEN
+bt_bool bt_ctf_value_compare(const struct bt_ctf_value *object_a,
+       const struct bt_ctf_value *object_b)
+{
+       bt_bool ret = BT_FALSE;
+
+       BT_ASSERT_PRE_NON_NULL(object_a, "Value object A");
+       BT_ASSERT_PRE_NON_NULL(object_b, "Value object B");
+
+       if (object_a->type != object_b->type) {
+               BT_LOGV("Values are different: type mismatch: "
+                       "value-a-addr=%p, value-b-addr=%p, "
+                       "value-a-type=%d, value-b-type=%d",
+                       object_a, object_b, object_a->type, object_b->type);
+               goto end;
+       }
+
+       ret = compare_funcs[object_a->type](object_a, object_b);
+
+end:
+       return ret;
+}
This page took 0.034838 seconds and 4 git commands to generate.