setlabel(3C)                 DG/UX 5.4 Rel. 2.01                setlabel(3C)


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

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 lfmt().

       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.

RETURN VALUE
       setlabel() returns 0 in case of success, nonzero otherwise.

EXAMPLE
       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

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

       getopt() 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.

SEE ALSO
       getopt(3C), lfmt(3C), pfmt(3C).















Licensed material--property of copyright holder(s)                         1