setlabel.3c (2010 09)

setlabel(3C) setlabel(3C)

NAME

setlabel() - deﬁne label for formatting routines

SYNOPSIS

#include <pfmt.h>

int setlabel(const char *label);

DESCRIPTION

The setlabel() system call deﬁnes 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 deﬁned before

setla-

bel().

setlabel() assumes that label has already been translated into a locale-speciﬁc string using the

current locale.

RETURN VALUE

setlabel() returns zero upon successful completion or nonzero if the routine failed.

EXAMPLES

This example, with no label deﬁned:

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

PAGE 1
setlabel(3C) setlabel(3C) NAME setlabel() - define label for formatting routines SYNOPSIS #include 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 setla- bel().
PAGE 2
(Notes) A (Notes) sA 2 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010