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

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

setlabel() .

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