---

4.3.1.1 Fixed Length String Key Pointer Value Array Excerpt

• Associative array regular constructor routine.

  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 Fixed Length String Key Pointer Value Array Types.

  See Fixed Length String Key Pointer Value Array Definitions.

  returns 0 for success, one of the defined errors for failure

• Plain data insertion routine.

  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

• Associative array regular destructor routine.

  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