- The corresponding <STRONG>key_name</STRONG> returns a character string corresponding to
- the wide-character value <EM>w</EM>. The two functions do not return the same
- set of strings; the latter returns null where the former would display
- a meta character.
+
+</PRE><H3><a name="h3-keyname_key_name">keyname/key_name</a></H3><PRE>
+ The <STRONG>keyname</STRONG> routine returns a character string corresponding to the key
+ <EM>c</EM>. Key codes are different from character codes.
+
+ <STRONG>o</STRONG> Key codes below 256 are characters. They are displayed using <STRONG>unc-</STRONG>
+ <STRONG>trl</STRONG>.
+
+ <STRONG>o</STRONG> Values above 256 may be the codes for function keys. The function
+ key name is displayed.
+
+ <STRONG>o</STRONG> Otherwise (if there is no corresponding name and the key is not a
+ character) the function returns null, to denote an error. X/Open
+ also lists an "UNKNOWN KEY" return value, which some implementa-
+ tions return rather than null.
+
+ The corresponding <STRONG>key_name</STRONG> returns a multibyte character string corre-
+ sponding to the wide-character value <EM>w</EM>. The two functions (<STRONG>keyname</STRONG> and
+ <STRONG>key_name</STRONG>) do not return the same set of strings:
+
+ <STRONG>o</STRONG> <STRONG>keyname</STRONG> returns null where <STRONG>key_name</STRONG> would display a meta character.
+
+ <STRONG>o</STRONG> <STRONG>key_name</STRONG> does not return the name of a function key.