[Overview][Constants][Types][Procedures and functions][Index] Reference for unit 'utility' (#aros)

AllocNamedObjectA

Allocate a named object.

Declaration

Source position: utility.pas line 242

function AllocNamedObjectA(

  const Name: STRPTR;

  TagList: PTagItem

):PNamedObject;

Arguments

Name

  

The name of the NamedObject. Obviously this must be specified

TagList

  

A TagList containing some extra information for this NamedObject. (ANO_*)

Function result

The object allocated, or nil for failure. The object is defined as a pointer to a pointer. You can do what you wish with the pointer. (It may be nil or contain a pointer to memory that you had asked for in the tags.)

Description

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.

See also

FreeNamedObject

  

Frees a name object.

ANO_NameSpace

  

Tag for AllocNamedObjectA(). Tag to define namespace

ANO_UserSpace

  

Tag for AllocNamedObjectA(). Taf to define userspace

ANO_Priority

  

Tag for AllocNamedObjectA(). Tag to define priority

ANO_Flags

  

Tag for AllocNamedObjectA(). Tag to define flags (NSF_*)


Documentation generated on: 2017-01-10