int x1f4_init_??fset(void **, unsigned, struct x1f4_??fset_type *)
creates a ??fset object, according the $2 bits (see ??fset
attribute bit definitions) and $3 setup values and stores the address of the
newly created associative array at $1
See Fixed Size Data Array Types.
See Fixed Size Data Array Definitions.
returns 0 for success, one of the defined errors for failure
int x1f4_post_??fset
(void *, void *, void **)
looks for some $1 associative array item matching the $2 key. Upon look up success, the start address of the found associative array element data is stored at $3. Upon look up failure, inserts a new element, corresponding the $2 key and stores the start address of the new element data at $3.
or:
inserts a new item corresponding the $2 key if none present, retrieves the corresponding item otherwise.
arguments:
the associative array
the key
the address where to store the address of the allocated item data if one is allocated
returns 0 if a new element was inserted, X1f4_??FSET_EVER_MATCH if a
match was found, one of the defined errors for failure
int x1f4_find_??fset
(void *, void *, void **)
looks for some $1 associative array item matching the $2 key. Upon success, the start address of the found associative array element data is stored at $3.
returns 0 if no match was found, non zero otherwise
int x1f4_cast_??fset
(void *, void *)
looks for some $1 associative array item matching the $2 key. Upon look up success, deletes the found associative array element.
returns 0 for success (deletion success that is), X1f4_??FSET_MISS_CLASS
for nonexistent matching node, one of the defined errors for failure
int x1f4_fini_??fset(void **)
destroys the associative array whose address is stored at $1 - dismantles it all and frees the associative array object
returns 0 for success, one of the defined errors for failure