| << SL_FindTagItem | SL_DamageWindow >> |
| Top: Documentation Library | Up: SoftLogik App Library API |
SL_NextTagItem
NAME
SL_NextTagItem -- iterate through a tag list.
SYNOPSIS
tag = SL_NextTagItem(tagItemPtr);
D0 A0
struct TagItem *SL_NextTagItem(struct TagItem **);
FUNCTION
Iterates through a tag list, skipping and chaining as dictated by
system tags. TAG_SKIP will cause it to skip the entry and a number
of following tags as specified in ti_Data. TAG_IGNORE ignores that
single entry, and TAG_MORE has a pointer to another array of tags (and
terminates the current array!). TAG_DONE also terminates the current
array. Each call returns either the next tagitem you should examine, or NULL when the end of the list has been reached.
INPUTS
tagItemPtr - doubly-indirect reference to a TagItem structure.
The pointer will be changed to keep track of the
iteration.
RESULTS
nextTag - each TagItem in the array or chain of arrays that should be
processed according to system tag values is returned in turn
with successive calls.
EXAMPLE
Iterate(struct TagItem *tags);
{
struct TagItem *tstate;
struct TagItem *tag;
tstate = tags;
while (tag = SL_NextTagItem(&tstate))
{
switch (tag->ti_Tag)
{
case TAG1: ...
break;
case TAG2: ...
break;
...
}
}
}
WARNING
Do NOT use the value of *tagItemPtr, but rather use the pointer
returned by SL_NextTagItem.
SEE ALSO
SL_FindTagItem.
SL_NextTagItem Command Section By Type url:SL_NextTagItem
created:2008-03-01 23:36:30 last updated:2008-03-01 23:36:30
Copyright © 1985-2024 GrasshopperLLC. All Rights Reserved.
| User Contributed Comments For SL_NextTagItem | sign in to add a comment |
| There are no user contributed comments for this page. | |
| << SL_FindTagItem | SL_DamageWindow >> |
| Top: Documentation Library | Up: SoftLogik App Library API |