HP-UX Reference (11i v1 00/12) - 3 Library Functions N-Z (vol 7)

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man3/nan.3m
________________________________________________________________
___ ___
s
setlabel(3C) setlabel(3C)
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:
INFO: file is writable
Using setlabel():
setlabel("my_appl");
pfmt(stderr, MM_INFO,"my_appl_cat:1:file is writable");
generates:
my_appl: INFO: file is writable
SEE ALSO
pfmt(3C).
STANDARDS COMPLIANCE
setlabel(): SVID3
HP-UX Release 11i: December 2000 − 1 − Section 3−−845
___
___