NAME
GetObjectName -- get the name for a library's associated object
SYNOPSIS
name = GetObjectName(xtraFile, libNum);
D0 A0 D0:16
char * name = GetObjectName(struct BlitzXtra * xtraFile, UWORD libNum);
FUNCTION
Each blitz library can have an associated 'object'. Each object has a unique
name, which is used when a programmer wishes to access a particular instance
of the object, or adjust the maximum instances of the object. This function
returns the name of the object associated with the given library.
INPUTS
xtraFile - a pointer to a valid BlitzXtra structure, as returned by a call
to either AllocXtra() or LoadXtra()
libNum - the library's identification number
RESULT
name - a pointer to the object's name (or NULL if the library does not
have an associated object)
BUGS
The memory used to return the string is shared. This means that
should two applications call this function together, the result is
unpredictable
SEE ALSO
GetObjectMaximum(), AllocXtra(), LoadXtra(), <libraries/blitz.h>,
<libraries/blitz.i>
converted with guide2html by Kochtopf