---

3.2.1.1 Fixed Size Data Array Excerpt

• Associative array regular constructor routine.

  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

• Plain data insertion routine.

  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:

  • - $1: void *

    the associative array

  • - $2: void *

    the key

  • - $3: void **

    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

• Plain search routine.

  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

• Plain data deletion routine.

  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

• Associative array regular destructor routine.

  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