---

2.1.1.1 Variable Size Data Sequence Excerpt

• Sequence regular constructor routine.

  int x1f4_init_??list(void **, unsigned, struct x1f4_??list_type *)
  

  creates an ??list object, according the $2 bits (see ??list attribute bit definitions) and $3 setup values and stores the address of the newly created sequence at $1

  The setup values in the struct x1f4_??list_type record pointed to by the $3 argument are only used if so requested by $2, the $3 argument is not considered otherwise.

  See Variable Size Data Sequence Types.

  See Variable Size Data Sequence Definitions.

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

• Plain data insertion routine

  int x1f4_push_??list(void *, unsigned, unsigned, void **)
  

  inserts a new element in the $2th position in the $1 sequence, with $3 usable bytes, to be found at the address stored at $4 after function call

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

• Plain data retrieval routine

  int x1f4_peek_??list(void *, unsigned, void **)
  

  stores the address of the data (i.e. payload) of the $1 sequence $2th element at $3

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

• Plain data deletion routine

  int x1f4_miss_??list(void *, unsigned)
  

  removes the $2th element from the $1 sequence

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

• Sequence regular destructor routine.

  int x1f4_fini_??list(void **)
  

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

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