Introduction:

• The toolkit supports an "adjunct" object. An adjunct is simply a handle which can be associated with any other object in the toolkit. The adjunct is carried along with the object, and can be retrieved at any time.

  dt_setadjunct(ob, myadj);
...
...
value = dt_adjunct(ob);

  What is important to recognize about the adjunct is that its " scope" is the same as the object. That is, anywhere that one can access the object, one can access the adjunct.

  This is a useful mechanism for associating data with objects.

• An adjunct is limited, however, to one piece of data, which must be a handle (or must look like one).

  The correct approach is to make an object (string, sequence, etc.) and package up any data in that object. However, there is a fair amount of overhead and grief associated with packaging/unpackaging data.

  This has promoted numerous "toolkit abuses":

  int val[20];
dt_setadjunct(ob, (dt_Handle)val);