int x1f4_init_??deck(void **, unsigned, struct x1f4_??deck_type *)
creates a ??deck object, according the $2 bits (see ??deck
attribute bit definitions) and $3 setup values and stores the address of the
newly created associative array at $1
The setup values in the struct x1f4_??deck_type record pointed to by
the $3 argument are only used if so requested by $2, the $3 argument is not
considered otherwise.
See String Key Pointer Value Array Types.
See String Key Pointer Value Array Definitions.
returns 0 for success, one of the defined errors for failure
int x1f4_post_??deck(void *, const char *, const void *)
looks for some $1 associative array node matching the $2 name. Upon look up failure, inserts a new element, corresponding the $2 name and storing the $3 pointer.
returns 0 if a new element was inserted, X1f4_??DECK_EVER_MATCH if a
match was found, one of the defined errors for failure
int x1f4_find_??deck(void *, const char *, const void **)
looks for some $1 associative array node matching the $2 name. Upon success, the pointer stored by the found element is stored at $3.
returns 0 if no match was found, non zero otherwise
int x1f4_pass_??deck(void *, const char *)
looks for some $1 associative array node matching the $2 name. Upon look up success, deletes the found associative array element.
returns 0 for success (deletion success or nonexistent matching node), one of the defined errors for failure
int x1f4_fini_??deck(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