Tag Set Functions

int kc_tag_set_construct(kc_tag_set_t** out_tag_set_ptr)

kc_tag_set_t* tags = NULL;
int result = kc_tag_set_construct(&tags);
if (result == 0) {
    // Use tag set...
    kc_tag_set_destruct(&tags);
}

int kc_tag_set_destruct(kc_tag_set_t** tag_set_ptr)

int kc_tag_set_add_string(
    kc_tag_set_t* tag_set_ptr,
    const char* key,
    const char* value
)

kc_tag_set_t* employee_info = NULL;
int result = kc_tag_set_construct(&employee_info);
if (result == 0) {
    kc_tag_set_add_string(employee_info, "name", "Alice Smith");
    kc_tag_set_add_string(employee_info, "department", "Engineering");
    kc_tag_set_add_string(employee_info, "role", "Senior Developer");

    // Use the tag set...
    kc_tag_set_destruct(&employee_info);
}

int kc_tag_set_add_int64(
    kc_tag_set_t* tag_set_ptr,
    const char* key,
    const int64_t value
)

kc_tag_set_add_int64(employee_info, "employee_id", 12345);
kc_tag_set_add_int64(employee_info, "salary", 95000);
kc_tag_set_add_int64(employee_info, "start_year", 2020);

int kc_tag_set_add_bool(
    kc_tag_set_t* tag_set_ptr,
    const char* key,
    const bool value
)

kc_tag_set_add_bool(employee_info, "is_manager", false);
kc_tag_set_add_bool(employee_info, "has_security_clearance", true);
kc_tag_set_add_bool(employee_info, "remote_work_eligible", true);

int kc_tag_set_add_double(
    kc_tag_set_t* tag_set_ptr,
    const char* key,
    const double value
)

kc_tag_set_add_double(employee_info, "performance_rating", 4.2);
kc_tag_set_add_double(employee_info, "bonus_multiplier", 1.15);

int kc_tag_set_get_string(
    const kc_tag_set_t* tag_set_ptr,
    const char* key,
    char** out_value,
    unsigned int* out_size
)

char* name = NULL;
unsigned int name_size = 0;
int result = kc_tag_set_get_string(employee_info, "name", &name, &name_size);
if (result == 0 && name) {
    printf("Employee name: %.*s\n", name_size, name);
    kc_common_delete_buffer(&name);
}

int kc_tag_set_get_int64(
    const kc_tag_set_t* tag_set_ptr,
    const char* key,
    int64_t* out_value
)

int64_t employee_id = 0;
int result = kc_tag_set_get_int64(employee_info, "employee_id", &employee_id);
if (result == 0) {
    printf("Employee ID: %lld\n", (long long)employee_id);
}

int kc_tag_set_get_bool(
    const kc_tag_set_t* tag_set_ptr,
    const char* key,
    bool* out_value
)

bool is_manager = false;
int result = kc_tag_set_get_bool(employee_info, "is_manager", &is_manager);
if (result == 0) {
    printf("Manager status: %s\n", is_manager ? "Yes" : "No");
}

int kc_tag_set_get_double(
    const kc_tag_set_t* tag_set_ptr,
    const char* key,
    double* out_value
)

double rating = 0.0;
int result = kc_tag_set_get_double(employee_info, "performance_rating", &rating);
if (result == 0) {
    printf("Performance rating: %.1f\n", rating);
}

int kc_tag_set_has_key(
    const kc_tag_set_t* tag_set_ptr,
    const char* key,
    bool* out_has_key
)

bool has_salary = false;
int result = kc_tag_set_has_key(employee_info, "salary", &has_salary);
if (result == 0) {
    if (has_salary) {
        int64_t salary = 0;
        kc_tag_set_get_int64(employee_info, "salary", &salary);
        printf("Salary: $%lld\n", (long long)salary);
    } else {
        printf("Salary information not available\n");
    }
}

int kc_tag_set_size(
    const kc_tag_set_t* tag_set_ptr,
    unsigned int* out_size
)

unsigned int tag_count = 0;
int result = kc_tag_set_size(employee_info, &tag_count);
if (result == 0) {
    printf("Employee record has %u fields\n", tag_count);
}

int kc_tag_set_keys(
    const kc_tag_set_t* tag_set_ptr,
    char*** out_keys,
    unsigned int* out_count
)

char** keys = NULL;
unsigned int key_count = 0;
int result = kc_tag_set_keys(employee_info, &keys, &key_count);
if (result == 0) {
    printf("Available fields:\n");
    for (unsigned int i = 0; i < key_count; i++) {
        printf("  - %s\n", keys[i]);
    }
    kc_common_delete_buffer_array(&keys, key_count);
}

int kc_tag_set_remove_key(
    kc_tag_set_t* tag_set_ptr,
    const char* key
)

// Remove sensitive information before sharing
int result = kc_tag_set_remove_key(employee_info, "salary");
if (result == 0) {
    printf("Salary information removed from record\n");
}

int kc_tag_set_clear(kc_tag_set_t* tag_set_ptr)

int kc_tag_set_serialize_to_string(
    const kc_tag_set_t* tag_set_ptr,
    char** out_content,
    unsigned int* out_size,
    const tkc_serialization_format serialization_format
)

char* json_output = NULL;
unsigned int json_size = 0;
int result = kc_tag_set_serialize_to_string(employee_info, &json_output, &json_size,
                                           TKC_SERIALIZATION_FORMAT_JSON);
if (result == 0) {
    printf("Employee data as JSON:\n%.*s\n", json_size, json_output);
    kc_common_delete_buffer(&json_output);
}

int kc_tag_set_equals(
    const kc_tag_set_t* lhs_ptr,
    bool* out_is_equal,
    const kc_tag_set_t* rhs_ptr
)

int kc_tag_set_is_null(
    const kc_tag_set_t* tag_set_ptr,
    bool* out_is_null
)