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)