Next: x1f4_head_program, Previous: x1f4_fini_program, Up: Imperative Language Interpreter Functions [Index]
extern int x1f4_flat_program
(void *program);
The x1f4_flat_program function visits every program variable and
for each variable of some application defined type defining a clean up method
(the very shut field in the struct x1f4_datatype_type data type
definition) calls the clean up defined by the type of variable while calling
the string clean up method with the string clean up context and the value of
the string variable as arguments (if such string clean up method and context
were defined) for each string variable found not to have the default string
variable value.
See Data Type Definition.
See struct x1f4_datatype_type.
The function returns 0 if no clean up method was ever called or no
called clean up method returned non zero, the non zero return of the clean up
otherwise.
See struct x1f4_c1_type.
See Imperative Language Interpreter Generation Flags.
See Execution Completion Cleanup.
The function may be called after an interrupted step by step program execution
to clear the still retained resources. The same is achieved by dismantling
the program executable representation (e.g. via x1f4_fini_program),
though the latter would preclude reuse. There would be no need to call the
function for normal (i.e. successfully completed) program execution, for not
step by step program execution and for when the step by step program execution
is making use of an explicit context.
Consolidated disposal (if in use) may defer resources release to an yet later
time, irrespective of which of x1f4_flat_program and
x1f4_fini_program is called. At any rate, one of the clearing functions
should be called, before triggering the consolidated disposal.
See x1f4_fini_program.
Next: x1f4_head_program, Previous: x1f4_fini_program, Up: Imperative Language Interpreter Functions [Index]