Return to index
NAME
obj_handler, obj_clear, obj_nnames, obj_name - object name support
SYNOPSIS
int
obj_handler(
int
argc,
char
**argv )
void
obj_clear(
void
)
extern int
obj_nnames
extern char
**obj_name
DESCRIPTION
The
obj_handler
routine should be assigned to the
MG_E_OBJECT
entry of the parser's
mg_ehand
array prior to calling
mg_load
if the loader/translator wishes to support hierarchical object
names.
The
obj_clear
function may be used to clear the object name stack and free any
associated memory, but this is usually not necessary since
o
begin and end entities are normally balanced in the input.
The global
obj_nnames
variable indicates the number of names currently in the object
stack, and the
obj_name
list contains the name strings in the same order as they were
encountered on the input.
(I.e. the most recently pushed name is last.)
DIAGNOSTICS
The
obj_handler
function returns
MG_OK
(0) if the color is handled correctly, or one of the predefined
error values if there is a problem.
(See the
mg_load
page for a list of errors.)
SEE ALSO
mg_init, mg_load,
xf_handler