bionic (3) chain.3.gz

NAME

       chain - mbk lisp-like service structure

DESCRIPTION

       The  chain  is  used  for  any purpose, when a list of pointer is required.  The use of this structure is
       strongly recommanded, when such a need occurs.

       The declarations needed to work on chain are available in the header file "/labo/include/mut315.h", where
       '315' is the actual mbk version.

       The following C structure supports the description of the chain :
              typedef struct chain {
                 struct chain     ∗NEXT;
                 void             ∗DATA;
              } chain_list;

       NEXT                Pointer to the next chain of the list.

       DATA                Generic  pointer  used  to  point  to  any  kind of object. Do not forget to cast the
                           pointer back to its previous type when using this field.

       Remark :            a  specialized  memory  allocator  has  been  built  in  order  to  create  and  free
                           chain_lists,  so absolutly avoid to create or free them an other way than through the
                           access functions.

SEE ALSO

       mbk(1), addchain(3), freechain(3), delchain(3).