UNCTRL(3XCURSES) X/Open Curses Library Functions UNCTRL(3XCURSES)
unctrl - generate printable representation of a character
cc [ flag... ] file... -I /usr/xpg4/include -L /usr/xpg4/lib \
-R /usr/xpg4/lib -lcurses [ library... ]
c89 [ flag... ] file... -lcurses [ library... ]
#include <unctrl.h>
char *unctrl(chtype c);
c
Is a character.
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.
Upon successful completion, the unctrl() function returns the
generated string. Otherwise, it returns a null pointer.
No errors are defined.
See attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | Unsafe |
+--------------------+-----------------+
addch(3XCURSES), addstr(3XCURSES), libcurses(3XCURSES),
wunctrl(3XCURSES), attributes(7), standards(7)
June 5, 2002 UNCTRL(3XCURSES)
NAME
unctrl - generate printable representation of a character
SYNOPSIS
cc [ flag... ] file... -I /usr/xpg4/include -L /usr/xpg4/lib \
-R /usr/xpg4/lib -lcurses [ library... ]
c89 [ flag... ] file... -lcurses [ library... ]
#include <unctrl.h>
char *unctrl(chtype c);
PARAMETERS
c
Is a character.
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 VALUES
Upon successful completion, the unctrl() function returns the
generated string. Otherwise, it returns a null pointer.
ERRORS
No errors are defined.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | Unsafe |
+--------------------+-----------------+
SEE ALSO
addch(3XCURSES), addstr(3XCURSES), libcurses(3XCURSES),
wunctrl(3XCURSES), attributes(7), standards(7)
June 5, 2002 UNCTRL(3XCURSES)