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>