1XStringToKeysym(3)              XLIB FUNCTIONS              XStringToKeysym(3)
2
3
4

NAME

6       XStringToKeysym, XKeysymToString, XKeycodeToKeysym, XKeysymToKeycode,
7       XConvertCase - convert keysyms
8

SYNTAX

10       KeySym XStringToKeysym(char *string);
11
12       char *XKeysymToString(KeySym keysym);
13
14       KeySym XKeycodeToKeysym(Display *display, KeyCode keycode, int index);
15
16       KeyCode XKeysymToKeycode(Display *display, KeySym keysym);
17
18       void XConvertCase(KeySym keysym, KeySym *lower_return, KeySym
19              *upper_return);
20

ARGUMENTS

22       display   Specifies the connection to the X server.
23
24       index     Specifies the element of KeyCode vector.
25
26       keycode   Specifies the KeyCode.
27
28       keysym    Specifies the KeySym that is to be searched for or converted.
29
30       lower_return
31                 Returns the lowercase form of keysym, or keysym.
32
33       string    Specifies the name of the KeySym that is to be converted.
34
35       upper_return
36                 Returns the uppercase form of keysym, or keysym.
37

DESCRIPTION

39       Standard KeySym names are obtained from <X11/keysymdef.h> by removing
40       the XK_ prefix from each name.  KeySyms that are not part of the Xlib
41       standard also may be obtained with this function.  The set of KeySyms
42       that are available in this manner and the mechanisms by which Xlib
43       obtains them is implementation-dependent.
44
45       If the KeySym name is not in the Host Portable Character Encoding, the
46       result is implementation-dependent.  If the specified string does not
47       match a valid KeySym, XStringToKeysym returns NoSymbol.
48
49       The returned string is in a static area and must not be modified.  The
50       returned string is in the Host Portable Character Encoding.  If the
51       specified KeySym is not defined, XKeysymToString returns a NULL.
52
53       The XKeycodeToKeysym function uses internal Xlib tables and returns the
54       KeySym defined for the specified KeyCode and the element of the KeyCode
55       vector.  If no symbol is defined, XKeycodeToKeysym returns NoSymbol.
56       XKeycodeToKeysym predates the XKB extension. If you want to lookup a
57       KeySym while using XKB you have to use XkbKeycodeToKeysym.
58
59       If the specified KeySym is not defined for any KeyCode, XKeysymToKey‐
60       code returns zero.
61
62       The XConvertCase function returns the uppercase and lowercase forms of
63       the specified Keysym, if the KeySym is subject to case conversion; oth‐
64       erwise, the specified KeySym is returned to both lower_return and
65       upper_return.  Support for conversion of other than Latin and Cyrillic
66       KeySyms is implementation-dependent.
67

SEE ALSO

69       XkbKeycodeToKeysym(3), XLookupKeysym(3)
70       Xlib - C Language X Interface
71
72
73
74X Version 11                     libX11 1.6.7               XStringToKeysym(3)
Impressum