NAME
setlabel() — define label for formatting routines
SYNOPSIS
#include <pfmt.h>
int setlabel(const char *label);
DESCRIPTION
The
setlabel()
system call defines a label to be printed by formatting
routines (see
pfmt(3C))
in the standard message format.
label
is a character string limited to 25 characters in length.
If
label
is NULL or an empty string,
the label is reset to no label.
No label is defined before
setlabel().
setlabel()
assumes that
label
has already been translated into a
locale-specific string using the
current locale.
APPLICATION USAGE
setlabel()
is thread-safe. It is not async-cancel-safe.
RETURN VALUE
setlabel()
returns zero upon successful completion or nonzero if the routine failed.
EXAMPLES
This example, with no label defined:
pfmt(stderr, MM_INFO,"my_appl_cat:1:file is writable");
generates:
Using
setlabel():
setlabel("my_appl");
pfmt(stderr, MM_INFO,"my_appl_cat:1:file is writable");
generates:
my_appl: INFO: file is writable
STANDARDS COMPLIANCE
setlabel(): SVID3
