NAME¶
VistaIOWarning, VistaIOSystemWarning - report a nonfatal error
SYNOPSIS¶
void VistaIOWarning ( format [, arg...])
VistaIOStringConst format;
void VistaIOSystemWarning ( format [, arg...])
VistaIOStringConst format;
ARGUMENTS¶
- format
- Specifies the format of the message that is to be reported.
- arg
- Specifies values that are to be included in the formatted message.
DESCRIPTION¶
VistaIOWarning is called to report a nonfatal error. It composes an error
message and passes it to the nonfatal error handler, which typically prints
the message and returns (see
VistaIOSetWarningHandler(3)).
The message composed by
VistaIOWarning is of the form:
Program: Warning: Description.
Program, the program's name, is included if it has been previously
established with a call to
VistaIOSetProgramName.
Description is
a string that has been formatted by
sprintf using
format, plus
all of the optional arguments,
arg.
VistaIOSystemWarning is identical to
VistaIOWarning except that it
also includes in the message a phrase based on the current value of the
external variable
errno, which is used by system calls to return
diagnostic codes. The message composed by
VistaIOSystemWarning is of
the form:
Program: Warning: Description: Diagnostic.
Diagnostic is a short phrase corresponding to the value of
errno.
This phrase is drawn from the table used by
perror(3).
EXAMPLES¶
In this first example, the values of
attr_name,
act_value, and
exp_value are incorporated into the error message produced by
VistaIOWarning.
char *attr_name;
float act_value, exp_value;
if (act_value != exp_value)
VistaIOWarning ("MyRoutine: Attribute %s is %f rather than %f",
attr_name, act_value, exp_value);
In this second example, the diagnostic phrase corresponding to the value of
errno is incorporated into the error message produced by
VistaIOSystemWarning.
if (ioctl (fd, request, arg) == -1)
VistaIOSystemWarning ("MyRoutine: ioctl failed");
SEE ALSO¶
VistaIOError(3),
VistaIOSetWarningHandler(3),
VistaIOSetProgramName(3),
perror(3),
AUTHOR¶
Art Pope <pope@cs.ubc.ca>
Adaption to vistaio: Gert Wollny <gw.fossdev@gmail.com>