NAME

libmawk_initialize_stage* - create a new libmawk context in 3 stages

SYNOPSIS

#include <libmawk.h>

mawk_state_t *libmawk_initialize_stage1(void);

mawk_state_t *libmawk_initialize_stage2(mawk_state_t * m,int s ,char*"argv[]);

mawk_state_t *libmawk_initialize_stage3(mawk_state_t * m);

DESCRIPTION

The libmawk_initialize_stage*() functions together do the same as libmawk_initialize() but allows the application to take actions between different stages. libmawk_initialize_stage1() returns a pointer to a newly created libmawk context. Any amount of libmawk contexts can live in parallel in an application.

libmawk_initialize_stage2() can be called after a succesful stage1 call.
Stage2 is responsible for processing the command line arguments and loading any script.

Arguments are the same as for a command line mawk session. Scripts are loaded (either from command line or from files using -f), variables are set (with -v), special options are set (with -W), etc. Unlike with libmawk_initialize(), the application may decide not to provide any script at this stage. All command line arguments are processed.

The most common case is that the application calls stage1 with no script, then already having a context makes some manipulations on it (for example registers some C functions that would be already called in the BEGIN part of the script that will be later loaded). Optionally before calling stage2 the application loads the actual script(s) using mawk_append_input_file().

libmawk_initialize_stage3() is called as a final step of the three-stage initialization process. Stage3 is responsible for running all the BEGIN parts of all scripts loaded at stage1 or stage2. It is useful to have stage3 in a separate call to allow applications to manipulate the context right before initializing the scripts.

Stage2 gets the pointer returned by stage1 and stage3 gets the pointer returned by stage2. Subsequent calls to libmawk functions should get the pointer returned by stage3.

RETURN VALUE

At stage 1 a pointer to a new libmawk context or NULL on error. Subsequent stages will return the same pointer or NULL on error.

SEE ALSO

libmawk_initialize_stage(3libmawk), libmawk_uninitialize(3libmawk), mawk_append_input_file(3libmawk).