---

5.1.1.4 Fixed Length String Set Library

• Set constructor routine.

  int x1f4_fast_??sset(void *, unsigned, struct x1f4_??sset_type *)
  

  sets up a newly allocated ??sset object, stored at $1, according the $2 bits (see ??sset attribute bit definitions) and $3 setup values

  The setup values in the struct x1f4_??sset_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 Set Types.

  See Fixed Length String Set Definitions.

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

• Set regular destructor routine.

  int x1f4_fini_??sset(void **)
  

  destroys the string set whose address is stored at $1 - dismantles it all and frees the object

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

• Set destructor routine.

  int x1f4_flat_??sset(void *)
  

  dismantles the $1 string set without freeing the memory for the object

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

• Data structure integrity check routine.

  int x1f4_flow_??sset(void *)
  

  checks the $1 string set for integrity - useful only for debugging this library

  return 0 for success, non 0 for failure to complete the integrity tests

• Set regular constructor routine.

  int x1f4_init_??sset(void **, unsigned, struct x1f4_??sset_type *)
  

  creates a ??sset object, according the $2 bits (see ??sset attribute bit definitions) and $3 setup values and stores the address of the newly created string set at $1

  The setup values in the struct x1f4_??sset_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 Set Types.

  See Fixed Length String Set Definitions.

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

• Data traversal routine.

  int x1f4_list_??sset
      (void *, void *, int (*)(void *, const char *), char *)
  

  calls $3 for each element in the $1 string set, with $2 and the name corresponding the element as arguments, in this order, until $3 returns non zero. The name will be a null terminated string. The name is constructed in the space pointed to by $4, where at least the key length plus one bytes need be storable.

  returns 0 if $3 was never called (i.e. string set is empty) or if $3 never returned non zero, the non zero return of $3 otherwise

• Plain data insertion routine.

  int x1f4_post_??sset(void *, const char *)
  

  looks for some $1 string set node matching the $2 name. Upon look up failure, inserts a new element, corresponding the $2 name.

  returns 0 if a new element was inserted, X1f4_??SSET_EVER_MATCH if a match was found, one of the defined errors for failure