NAME AllocateTagItems -- Allocate a tagitem array (or chain). (v36) SYNOPSIS tagList = AllocateTagItems( numItems ) D0 D0 struct tagitem *allocatetagitems( ulong numitems); FUNCTION Allocates the specified number of usable TagItems slots, and does so in a format that the function freetagitems can handle. Note that to access the TagItems in 'tagList', you should use the function nexttagitem(). this will insure you respect any chaining (TAG_MORE) that the list uses, and will skip any TAG_IGNORE items that AllocateTagItems() might use to stash size and other information. INPUTS numItems - the number of tagitem slots you want to allocate. RESULT tagList - the allocated chain of tagitem structures. will return NULL if unsuccessful. BUGS SEE ALSO freetagitems(), clonetagitems()