wunctrl(3xcurses) [opensolaris man page]

wunctrl(3XCURSES)					  X/Open Curses Library Functions					 wunctrl(3XCURSES)

NAME

       wunctrl - generate printable representation of a wide 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 <curses.h>

       wchar_t *wunctrl(cchar_t *wc);

PARAMETERS

       wc    Is a pointer to the wide character.

DESCRIPTION

       The wunctrl() function converts the a wide character string that is a printable representation of the wide character wc.

       This function also performs the following processing on the input argument:

	   o	  Control characters are converted to the ^X notation

	   o	  Any rendition information is removed.

RETURN VALUES

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

ERRORS

       No errors are defined.

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       keyname(3XCURSES), libcurses(3XCURSES), unctrl(3XCURSES), attributes(5), standards(5)

SunOS 5.11							    5 Jun 2002							 wunctrl(3XCURSES)

keyname(3XCURSES)					  X/Open Curses Library Functions					 keyname(3XCURSES)

NAME

       keyname, key_name - return character string used as key name

SYNOPSIS

       cc [ flag... ] file... -I /usr/xpg4/include -L /usr/xpg4/lib 
       -R /usr/xpg4/lib -lcurses [ library... ]

       c89 [ flag... ] file... -lcurses [ library... ]

       #include <curses.h>

       char *keyname(int c);

       char *key_name(wchar_t wc);

PARAMETERS

       c		       Is an 8 bit-character or a key code.

       wc		       Is a wide character key name.

DESCRIPTION

       The keyname() function returns a string pointer to the key name.   Make a duplicate copy of the returned string if you plan to modify it.

       The key_name() function is similar except that it accepts a wide character key name.

       The following table shows the format of the key name based on the input.

       +----------------------------------------------------------------------+
       |Input				  Format of Key Name		      |
       |Visible character		  The same character		      |
       |Control character		  ^X				      |
       |Meta-character (keyname() only)   M-X				      |
       |Key value defined in <curses.h>   KEY_name			      |
       |(keyname() only)						      |
       |None of the above		  UNKNOWN KEY			      |
       +----------------------------------------------------------------------+

       In the preceding table, X can be either a visible character with the high bit cleared or a control character.

RETURN VALUES

       On success, these functions return a pointer to the string used as the key's name. Otherwise, they return a null pointer.

ERRORS

       None.

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       libcurses(3XCURSES), meta(3XCURSES), attributes(5), standards(5)

SunOS 5.10							    5 Jun 2002							 keyname(3XCURSES)