Next: , Previous: , Up: Imperative Language Interpreter Functions   [Index]


5.9.3.5 x1f4_flat_program

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 Consolidated Disposal.

See x1f4_fini_program.

See Step By Step Imperative Program Execution.


Next: x1f4_head_program, Previous: x1f4_fini_program, Up: Imperative Language Interpreter Functions   [Index]