setlabel(3C)

setlabel -- define the label for pfmt

Synopsis

   #include <pfmt.h>
   
   int setlabel(const char label);

Description

The routine setlabel defines the label for messages produced in standard format by subsequent calls to pfmt and vpfmt.

label is a character string no more than 25 characters in length.

No label is defined before setlabel is called. A null pointer or an empty string passed as argument will reset the definition of the label.

Errors

setlabel returns 0 in case of success, non-zero otherwise.

Usage

The following code (without previous call to setlabel):

   pfmt(stderr, MM_ERROR, "test:2:Cannot open file\n");
   setlabel("UX:test");
   pfmt(stderr, MM_ERROR, "test:2:Cannot open file\n");

will produce the following output:

   ERROR: Cannot open file
   UX:test: ERROR: Cannot open file

References

getopt(3C), pfmt(3C)

Notices

The label should be set once at the beginning of a utility and remain constant.

getopt(3C) has been modified to report errors using the standard message format. If setlabel is called before getopt, getopt will use that label. Otherwise, getopt will use the name of the utility.