This function returns an array placeholder. A placeholder is used to identify a position in the underlying data system (HDS) and may be passed to other routines (e.g. aryNew) to indicate where a newly created array should be positioned.

void aryPlace( HDSLoc $\ast$loc, const char $\ast$name, AryPlace $\ast$$\ast$place, int $\ast$status )

• Placeholders are intended only for local use within an application and only a limited number of them are available simultaneously. They are always annulled as soon as they are passed to another routine to create a new array, where they are effectively exchanged for an array identifier.

• If this routine is called with " status" set, then a value of NULL will be returned for the " place" argument, although no further processing will occur. The same value will also be returned if the routine should fail for any reason.

loc

name

place

status