X/Open Curses Library Functions                 keyname(3XCURSES)



NAME
     keyname, keyname - 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 

     char *keyname(int c);


     char *keyname(wchart 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 keyname() 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.



















SunOS 5.11           Last change: 5 Jun 2002                    1






X/Open Curses Library Functions                 keyname(3XCURSES)



     
     Input                             Format of Key Name                 
     Visible character                 The same character                 
     Control character                 ^X                                 
     Meta-character (keyname() only)   M-X                                
     Key value defined in    KEYname                           
     (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.

ERORS
     None.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     libcurses(3XCURSES),  meta(3XCURSES),  attributes(5),  stan-
     dards(5)














SunOS 5.11           Last change: 5 Jun 2002                    2