UTerror


Routine

void UTerror (const char Errmsg[], ...)

Purpose

Print error messages, stop with error status set

Description

This routine prints the system error message corresponding to the last system error encountered. It first prints a user supplied text, and then prints the system error message. Messages are written to stderr (standard error). Execution is terminated and the exit status is set to EXIT_FAILURE. Normally this routine is called after a system routine has returned an error condition.

The system error message is printed using perror. The preamble to the system error message is either the name of this routine or the string supplied to UTsetProg. An example of the use of this routine is as follows.

  UTsetProg ("XXProg");
  ...
  fp = fopen (Fname, ...);
  if (fp == NULL)
    UTerror ("XXProc: Cannot open file \"%s\"", Fname);
If fopen fails, a typical output to stderr would be:
  XXProc: Cannot open file "abc"
  XXProg: No such file or directory

Parameters

-> const char Errmsg[]
Character string to be printed. This string can contain optional formatting codes. The arguments corresponding to the formatting codes appear at the end of the argument list. The input string should not normally have a terminating newline character, since this routine supplies a newline.
-> <args...>
Arguments corresponding to the formatting codes. The format string and the variable number of arguments is passed on to the system routine vprintf.

Author / revision

P. Kabal Copyright (C) 1996 / Revision 1.18 1996/03/25

See Also

UThalt, UTwarn


Main Index libtsp