NAME

       cs_init  - create and initialize a CS context

SYNOPSIS

       #include <cs/cs.h>

       NEOERR *cs_init (CSPARSE **parse, HDF *hdf);

ARGUMENTS

       parse - a pointer to a pointer to a CSPARSE structure that
       will be created
       hdf - the HDF dataset to be used during parsing and rendering

DESCRIPTION

       cs_init  will  create a CSPARSE structure and initialize it.  This structure maintains the
       state and information necessary for parsing and rendering a CS template.

       MT-Level: cs routines perform no locking, and neither do hdf  routines.   They  should  be
       safe in an MT environment as long as they are confined to a single thread.

RETURN VALUE

       parse will contain a pointer to the allocated CSPARSE
       structure.  This structure will be deallocated with
       cs_destroy()

SEE ALSO

       cs_dump(3),  cs_destroy(3),  cs_render(3),  cs_register_esc_strfunc(3),  cs_arg_parsev(3),
       cs_register_fileload(3),     cs_init(3),     cs_register_strfunc(3),      cs_arg_parse(3),
       cs_parse_string(3), cs_parse_file(3), =(3), cs_register_function