setlabel(3C)

NAME

     setlabel - define the label for pfmt() and lfmt()

SYNOPSIS

     #include <pfmt..h>

     int setlabel(const char *label);

DESCRIPTION

     The setlabel() function defines the label for messages  pro-
     duced in standard format by subsequent calls to lfmt(3C) and
     pfmt(3C).

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

     No label is defined before setlabel() is called.  The  label
     should  be set once at the beginning of a utility and remain
     constant. A null pointer or an empty string passed as  argu-
     ment will reset the  definition of the label.

RETURN VALUE

     Upon successful completion, setlabel() returns 0; otherwise,
     it returns a non-zero value.

EXAMPLES

     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

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|

SEE ALSO

     getopt(3C), lfmt(3C), pfmt(3C), attributes(5)