XKeysymToString − convert a keysym symbol to a string.

Synopsis

char *XKeysymToString(keysym)
KeySym keysym;

Arguments

keysymSpecifies the keysym that is to be converted. 

Description

XKeysymToString() converts a keysym symbol (a number) into a character string.  The returned string is in a static area and must not be modified.  The returned string is in the Host Portable Character Encoding.  If the specified keysym is not defined, XKeysymToString() returns NULL.  For example, XKeysymToString() converts XK_Shift to "Shift".  Note that XKeysymString does not return the string that is mapped to the keysym, but only a string version of the keysym itself.  In other words, even if the F1 key is mapped to the string "STOP" using XRebindKeysym(), XKeysymToString() still returns "F1".  XLookupString(), however, would return "STOP".  In Release 4, XKeysymToString() can process keysyms that are not defined by the Xlib standard.  Note that the set of keysyms that are available in this manner and the mechanisms by which Xlib obtains them is implementation dependent.  (In the MIT sample implementation, the resource file /usr/lib/X11/XKeysymDB is used starting in Release 4.  The keysym name is used as the resource name, and the resource value is the keysym value in uppercase hexadecimal.) 

See Also

IsCursorKey(), IsFunctionKey(), IsKeypadKey(), IsMiscFunctionKey(), IsModifierKey(), IsPFKey(), XChangeKeyboardMapping(), XDeleteModifiermapEntry(), XFreeModifiermap(), XGetKeyboardMapping(), XGetModifierMapping(), XInsertModifiermapEntry(), XKeycodeToKeysym(), XKeysymToKeycode(), XLookupKeysym(), XLookupString(), XNewModifierMap, XQueryKeymap(), XRebindKeysym(), XRefreshKeyboardMapping(), XSetModifierMapping(), XStringToKeysym(). 

Copyright O’Reilly & Assoc.  —