NAME
    FilterTagItems - Remove selected items from a tagitem list. (v36)

SYNOPSIS
    nvalid = FilterTagItems(tagList, tagArray, logic)
    D0                     A0       A1        D0

    ULONG FilterTagItems(struct tagitem *taglist, tag *tagarray,
                         LONG logic);

FUNCTION
    Removes TagItems from a tagitem list (by changing ti_tag to
    TAG_IGNORE) depending on whether its ti_Tag value is
    found in an array of TagValues.

    If the 'logic' parameter is TAGFILTER_AND, then all items
    not appearing in the list are excluded.

    If 'logic' is TAGFILTER_NOT, then items not found in the
    array are preserved, and the ones in the array are cast out.

INPUTS
    tagList         - input list of tag items which is to be filtered
                      by having selected items changed to TAG_IGNORE.
    tagArray        - an array of Tag values, terminated by TAG_END,
                      as specified in the notes on taginarray().
    logic           - specification whether items in TagArray are to
                      be included or excluded in the filtered result.

RESULT
    nvalid          - number of valid items left in resulting filtered
                      list.

BUGS

SEE ALSO
    taginarray()