libamxc  1.10.3
C Generic Data Containers
amxc_variant_type.h
Go to the documentation of this file.
1 /****************************************************************************
2 **
3 ** SPDX-License-Identifier: BSD-2-Clause-Patent
4 **
5 ** SPDX-FileCopyrightText: Copyright (c) 2023 SoftAtHome
6 **
7 ** Redistribution and use in source and binary forms, with or without modification,
8 ** are permitted provided that the following conditions are met:
9 **
10 ** 1. Redistributions of source code must retain the above copyright notice,
11 ** this list of conditions and the following disclaimer.
12 **
13 ** 2. Redistributions in binary form must reproduce the above copyright notice,
14 ** this list of conditions and the following disclaimer in the documentation
15 ** and/or other materials provided with the distribution.
16 **
17 ** Subject to the terms and conditions of this license, each copyright holder
18 ** and contributor hereby grants to those receiving rights under this license
19 ** a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable
20 ** (except for failure to satisfy the conditions of this license) patent license
21 ** to make, have made, use, offer to sell, sell, import, and otherwise transfer
22 ** this software, where such license applies only to those patent claims, already
23 ** acquired or hereafter acquired, licensable by such copyright holder or contributor
24 ** that are necessarily infringed by:
25 **
26 ** (a) their Contribution(s) (the licensed copyrights of copyright holders and
27 ** non-copyrightable additions of contributors, in source or binary form) alone;
28 ** or
29 **
30 ** (b) combination of their Contribution(s) with the work of authorship to which
31 ** such Contribution(s) was added by such copyright holder or contributor, if,
32 ** at the time the Contribution is added, such addition causes such combination
33 ** to be necessarily infringed. The patent license shall not apply to any other
34 ** combinations which include the Contribution.
35 **
36 ** Except as expressly stated above, no rights or licenses from any copyright
37 ** holder or contributor is granted under this license, whether expressly, by
38 ** implication, estoppel or otherwise.
39 **
40 ** DISCLAIMER
41 **
42 ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
43 ** AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
44 ** IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
45 ** ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
46 ** LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
47 ** DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
48 ** SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
49 ** CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
50 ** OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
51 ** USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
52 **
53 ****************************************************************************/
54 
55 #if !defined(__AMXC_VARIANT_TYPE_H__)
56 #define __AMXC_VARIANT_TYPE_H__
57 
58 #ifdef __cplusplus
59 extern "C"
60 {
61 #endif
62 
63 #include <amxc/amxc_htable.h>
64 #include <amxc/amxc_variant.h>
65 #include <amxc/amxc_common.h>
66 
87 typedef int (* amxc_var_new_fn_t) (amxc_var_t* const var);
88 
94 typedef void (* amxc_var_free_fn_t) (amxc_var_t* const var);
95 
101 typedef int (* amxc_var_copy_fn_t) (amxc_var_t* const dst,
102  const amxc_var_t* const src);
103 
109 typedef int (* amxc_var_move_fn_t) (amxc_var_t* const dst,
110  amxc_var_t* const src);
111 
118 typedef int (* amxc_var_convert_fn_t) (amxc_var_t* const dest,
119  const amxc_var_t* const src);
120 
127 typedef int (* amxc_var_compare_fn_t) (const amxc_var_t* const var1,
128  const amxc_var_t* const var2,
129  int* const result);
130 
136 typedef amxc_var_t*(* amxc_var_get_key_fn_t) (const amxc_var_t* const src,
137  const char* const key,
138  int flags);
139 
145 typedef int (* amxc_var_set_key_fn_t) (amxc_var_t* const dest,
146  amxc_var_t* const src,
147  const char* const key,
148  int flags);
149 
155 typedef amxc_var_t*(* amxc_var_get_index_fn_t) (const amxc_var_t* const src,
156  const int64_t index,
157  int flags);
158 
164 typedef int (* amxc_var_set_index_fn_t) (amxc_var_t* const dest,
165  amxc_var_t* const src,
166  const int64_t index,
167  int flags);
168 
211 typedef struct _amxc_var_type {
223  uint32_t type_id;
225  const char* name;
227 
249 uint32_t amxc_var_register_type(amxc_var_type_t* const type);
250 
274 
288 const char* amxc_var_get_type_name_from_id(const uint32_t type_id);
289 
303 uint32_t amxc_var_get_type_id_from_name(const char* const name);
304 
318 amxc_var_type_t* amxc_var_get_type(unsigned int type_id);
319 
320 
321 #ifdef __cplusplus
322 }
323 #endif
324 
325 #endif // __AMXC_VARIANT_TYPE_H__
Ambiorix hash table API header file.
Ambiorix variant API header file.
int(* amxc_var_compare_fn_t)(const amxc_var_t *const var1, const amxc_var_t *const var2, int *const result)
Variant type callback function prototype comparing two variants of the same type.
int(* amxc_var_set_index_fn_t)(amxc_var_t *const dest, amxc_var_t *const src, const int64_t index, int flags)
Variant type callback function prototype set part of variant by index.
amxc_var_t *(* amxc_var_get_index_fn_t)(const amxc_var_t *const src, const int64_t index, int flags)
Variant type callback function prototype fetch part of variant by index.
int(* amxc_var_set_key_fn_t)(amxc_var_t *const dest, amxc_var_t *const src, const char *const key, int flags)
Variant type callback function prototype set part of variant by key.
amxc_var_t *(* amxc_var_get_key_fn_t)(const amxc_var_t *const src, const char *const key, int flags)
Variant type callback function prototype fetch part of variant by key.
int(* amxc_var_convert_fn_t)(amxc_var_t *const dest, const amxc_var_t *const src)
Variant type callback function prototype for dynamically converting one type to another.
uint32_t amxc_var_register_type(amxc_var_type_t *const type)
Register a new variant type.
void(* amxc_var_free_fn_t)(amxc_var_t *const var)
Variant type callback function prototype for freeing previous allocated memory.
amxc_var_type_t * amxc_var_get_type(unsigned int type_id)
Get the type definition structure.
uint32_t amxc_var_get_type_id_from_name(const char *const name)
Get the type id.
int(* amxc_var_move_fn_t)(amxc_var_t *const dst, amxc_var_t *const src)
Variant type callback function prototype for moving the content.
int amxc_var_unregister_type(amxc_var_type_t *const type)
Unregisters an already registered variant type.
const char * amxc_var_get_type_name_from_id(const uint32_t type_id)
Get the type name.
int(* amxc_var_new_fn_t)(amxc_var_t *const var)
Variant type callback function prototype for initializing a variant of a certain type.
struct _amxc_var_type amxc_var_type_t
A variant type structure.
int(* amxc_var_copy_fn_t)(amxc_var_t *const dst, const amxc_var_t *const src)
Variant type callback function prototype for creating a copy.
The hash table iterator structure.
Definition: amxc_htable.h:138
A variant type structure.
amxc_var_get_key_fn_t get_key
amxc_var_get_index_fn_t get_index
amxc_var_compare_fn_t compare
amxc_var_move_fn_t move
amxc_var_free_fn_t del
const char * name
amxc_var_set_key_fn_t set_key
amxc_var_convert_fn_t convert_from
amxc_var_convert_fn_t convert_to
amxc_var_set_index_fn_t set_index
amxc_var_copy_fn_t copy
amxc_var_new_fn_t init
amxc_htable_it_t hit
The variant struct definition.
Definition: amxc_variant.h:861
static amxc_var_t * var
Definition: test_issue_58.c:77