[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


   NAME
        CloneTagItems -- copy a tag list. (V36)

   SYNOPSIS
        clone = CloneTagItems(original);
        D0                    A0

        struct tagitem *clonetagitems(struct tagitem *);

   FUNCTION
        Copies the essential contents of a tag list into a new tag list.

        The cloning is such that calling findtagitem() with a given tag on
        the original or cloned tag lists will always return the same
        tag value. That is, the ordering of the tags is maintained.

   INPUTS
        original - tag list to clone. May be NULL, in which case an
                   empty tag list is returned.

   RESULTS
        clone - copy of the original tag list, or NULL if there was not enough
                memory. This tag list must eventually by freed by calling
                freetagitems().

   SEE ALSO
        <utility/tagitem.h>, allocatetagitems(), freetagitems(),
        refreshtagitemclones()