Content-type: text/html Man page of setlabel

setlabel

Section: Standard C Library Functions (3C)
Updated: 29 Dec 1996
Index Return to Main Contents
 

NAME

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

SYNOPSIS

#include <pfmt..h>

int setlabel(const char *label);  

DESCRIPTION

The setlabel() function defines the label for messages produced in standard format by subsequent calls to lfmt(3C) and pfmt(3C).

The label argument is a character string no more than 25 characters in length.

No label is defined before setlabel() is called. The label should be set once at the beginning of a utility and remain constant. A null pointer or an empty string passed as argument will reset the definition of the label.  

RETURN VALUE

Upon successful completion, setlabel() returns 0; otherwise, it returns a non-zero value.  

EXAMPLES

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

 

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
MT-LevelMT-Safe

 

SEE ALSO

getopt(3C), lfmt(3C), pfmt(3C), attributes(5)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
EXAMPLES
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:37:27 GMT, October 02, 2010