CURSES

NAME

unctrl — generate printable representation of a character

SYNOPSIS

#include <unctrl.h>

char *unctrl(chtype c);

DESCRIPTION

The unctrl() function generates a character string that is a printable representation of c.  If c is a control character, it is converted to the ^X notation.  If c contains rendition information, the effect is undefined. 

RETURN VALUE

Upon successful completion, unctrl() returns the generated string.  Otherwise, it returns a null pointer. 

ERRORS

No errors are defined. 

SEE ALSO

keyname(), wunctrl(), <unctrl.h>. 

CHANGE HISTORY

First released in X/Open Curses, Issue 2. 

X/Open Curses, Issue 4

The entry is rewritten for clarity.  The RETURN VALUE section now states that the function may return a null pointer.  This condition was not specified in previous issues. 

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996