NAME
        AllocLocalItem -- create a local context item structure. (V36)

   SYNOPSIS
        item = AllocLocalItem(type, id, ident, dataSize);
        D0                    D0    D1  D2     D3

        struct localcontextitem *alloclocalitem(long, long, long, long);

   FUNCTION
        Allocates and initializes a localcontextitem structure with "datasize"
        bytes of associated user data. This is the only supported way to
        create such an item. The user data can be accessed with the
        localitemdata() function. an item created with this function
        automatically has its purge vectors set up correctly to dispose of
        itself and its associated user data area. Any additional cleanup
        should be done with a user-supplied purge vector.

   INPUTS
        type,id - additional longword identification values
        ident - longword identifier for class of context item
        dataSize - number of bytes of user data to allocate for this item

   RESULT
        item - pointer to initialized localcontextitem or null if the
               allocation failed.

   SEE ALSO
        freelocalitem(), localitemdata(), storelocalitem(),
        storeitemincontext(), setlocalitempurge(), <libraries/iffparse.h>