(C) 1998 AROS - The Amiga Research OS


NAME
#include <proto/utility.h>

ULONG FilterTagItems (tagList , filterArray , logic)

LOCATION
In UtilityBase at offset 16

SYNOPSIS
struct TagItem * tagList
Tag * filterArray
ULONG logic

FUNCTION
Scans a tag list and removes tag items from the list depending upon whether the tag's Tag value is found in an array of tag values.

If 'logic' is TAGFILTER_AND, then all the tags that are NOT in the array filterArray will be removed from the tagList.

If 'logic' is TAGFILTER_NOT, then all the tags that ARE in the array filterArray will be removed from the tagList.

Tags are removed by setting their ti_Tag value to TAG_IGNORE.

INPUTS
tagList
A TagList to filter items from.
filterArray
An array (as described by TagInArray()) to determine which tag items are to be removed.
logic
Whether the tags in filterArray are to be included or excluded from the tag list.

RESULT
The number of valid items left in the resulting filtered list.

EXAMPLE

SEE ALSO
TagInArray()

NOTES

BUGS

INTERNALS

HISTORY
20.10.1998 hkiel
Amiga Research OS
20.08.1997 digulla
Polish.

Renamed utility_intern.h to intern.h.

27.01.1997 ldp
Polish
08.01.1997 iaint
A few more utility.lib functions