(C) 1998 AROS - The Amiga Research OS


NAME
#include <proto/utility.h>

struct NamedObject * AllocNamedObjectA (name , tagList)

LOCATION
In UtilityBase at offset 38

SYNOPSIS
STRPTR name
struct TagItem * tagList

FUNCTION
Allocate a new NamedObject and initializes it as requested. This object can then be used as an object in a name space. Optionally you give this object a name space, and use it to nest name spaces. You can also allocate some memory which is attached to this object for your own personal use.

When the object is allocated, it will automatically have one user. To allow other users to remove this object from a namespace, you must call ReleaseNamedObject() on this object.

INPUTS
name
The name of the NamedObject. Obviously this MUST be specified (otherwise it wouldn't be named would it?)
tagList
A TagList containing some extra information for this NamedObject. These are:

ANO_NameSpace: Allocate a NameSpace for this NamedObject. This will allow you to link other NamedObjects into a group. You cannot add a NamedObject with a NameSpace to another NameSpace. Boolean, default is FALSE.

ANO_UserSpace: This tag says that you want extra memory allocated for a UserSpace. The ti_Data field of this TagItem contains the amount of memory to allocate. Specifying this Tag with a ti_Data of 0, is equivalent to the default, which is no UserSpace. The UserSpace address can be found in the no_Object field of the NamedObject structure.

ANO_Priority: This is the List priority of the NamedObject and should be a signed BYTE value

between
128 and 127. This is taken into account in adding and finding NamedObjects, as the highest priority NamedObject will be returned first. The default value is 0.

ANO_Flags: This allows you to initialize the value of the NameSpace flags which control certain aspects of the NameSpace. See the file utility/name.h.

RESULT
A pointer to a new NamedObject, or NULL if the allocation failed due to no free memory.

EXAMPLE

SEE ALSO
FreeNamedObject()

NOTES

BUGS

INTERNALS

HISTORY
20.10.1998 hkiel
Amiga Research OS
02.10.1997 digulla
Use the macro NEWLIST() over NewList() to get rid of an external symbol.
20.08.1997 digulla
Polish.

Renamed utility_intern.h to intern.h.

09.02.1997 iaint
Fixed some nasty bugs in NamedObjects
27.01.1997 digulla
Added #include <proto/exec.h>
27.01.1997 ldp
Polish
18.12.1996 iaint
NamedObjects