NAME

       PX_new3 — create new instance of Paradox file

SYNOPSIS

       #include <paradox.h>

       pxdoc_t* PX_new3(void  (*errorhandler)(pxdoc_t *p, int type, const char *msg, void *para),
       void*   (*allocproc)(pxdoc_t   *p,   size_t   size,    const    char    *caller),    void*
       (*reallocproc)(pxdoc_t   *p,   void   *mem,   size_t   size,  const  char  *caller),  void
       (*freeproc)(pxdoc_t *p, void *mem), void *errorhandler_user_data)

DESCRIPTION

       Creates a new instance of a Paradox file. This function, PX_new(3) or PX_new2(3)  must  be
       called  before  any other functions. If the caller has its own error and memory management
       functions they can be passed.

       In opposition to PX_new2(3) this function has an  extra  parameter  errorhandler_user_data
       which  is  a  pointer  to  user  data which is passed to the error handler function as the
       fourth parameter. This could be used to pass e.g. a widget pointer where error message are
       to  be  output,  or a context which otherwise had to passed to the error handler through a
       global variable.

RETURN VALUE

       Returns a pointer to an internal representation of a Paradox file or NULL on failure.

SEE ALSO

       PX_new(3), PX_new2(3), PX_open_file(3), PX_open_fp(3)

AUTHOR

       This manual page was written by Uwe Steinmann uwe@steinmann.cx.

                                                                                       PX_NEW3(3)