NAME

       VistaIOSetWarningHandler - register a procedure to be called on any nonfatal error

SYNOPSIS

       void VistaIOSetWarningHandler (VistaIOWarningHandler *handler)

       typedef void VistaIOWarningHandler (VistaIOStringConst message);

       void VistaIODefaultWarning (VistaIOStringConst message);

ARGUMENTS

       handler   Specifies the new nonfatal error handler.

       message   Specifies a null-terminated error message string to be reported.

DESCRIPTION

       VistaIOSetWarningHandler  registers  a  procedure, handler, as the nonfatal error handler.
       That procedure is called by VistaIOWarning(3) or by VistaIOSystemWarning(3) to report  any
       nonfatal  error.  When  called  it  is  passed  a  string,  message,  containing a textual
       description of the error.

       Only one procedure serves as the nonfatal error handler at any one time.

       Prior to the first call to VistaIOSetWarningHandler, the  procedure  VistaIODefaultWarning
       is the nonfatal error handler. This procedure will write the error message to the standard
       error stream, then return.  VistaIODefaultWarning can be re-established as the fatal error
       handler at any time by calling VistaIOSetWarningHandler with a NULL argument.

EXAMPLES

       To adopt a warning handler that writes messages both to the standard error stream and to a
       log file, one might do the following:

              FILE *log_file;

              void MyWarningHandler (message)
                   VistaIOStringConst message;
              {
                   fputs (message, stderr);
                   fputs (message, log_file);
              }

              int main (...)
              {
                   ...
                   log_file = fopen ("log", "w");
                   VistaIOSetWarningHandler (MyWarningHandler);
                   ...
              }

SEE ALSO

       VistaIOWarning(3), VistaIOSetErrorHandler(3),

AUTHOR

       Art Pope <pope@cs.ubc.ca>

       Adaption to vistaio: Gert Wollny <gw.fossdev@gmail.com>