(C) 1998 AROS - The Amiga Research OS


NAME
#include <utility/tagitem.h>
#include <proto/utility.h>

struct TagItem * AllocateTagItems (numTags)

LOCATION
In UtilityBase at offset 11

SYNOPSIS
ULONG numTags

FUNCTION
Allocate a number of TagItems in an array for whatever you like. The memory allocated will be cleared.

INPUTS
numTags
The number of TagItems to allocate.

RESULT
A pointer to an array of struct TagItem containing numTags tags.

EXAMPLE
struct TagItem *tagList;

tagList =  AllocateTagItems( 4 );

tagList[0].ti_Tag  = NA_Name;
tagList[0].ti_Data = (IPTR)"A list of tags";
tagList[3].ti_Tag  = TAG_DONE;

\* Do what you want with your TagList here ... *\

FreeTagItems( tagList );
SEE ALSO
FreeTagsItems()

NOTES
The number you supply must include the terminating tag (ie TAG_DONE) There is no provision for extra TagItems at the end of the list.

If the number of tags to allocate is zero, then none will be.

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 digulla
Added #include <proto/exec.h>
27.01.1997 ldp
Polish
10.12.1996 aros
Moved #include into first column to allow makedepend to see it.
24.10.1996 aros
Use proper Amiga datatypes (eg: ULONG not unsigned long)
24.10.1996 aros
Use the official AROS macros over the __AROS versions.
13.09.1996 digulla
Use IPTR
12.09.1996 digulla
Better way to separate public and private parts of the library base
31.08.1996 aros
Merged in/modified for FreeBSD.