int XLookupString(event_struct, buffer_return, bytes_buffer, keysym_return, status_in_out) XKeyEvent *event_struct; char *buffer_return; int bytes_buffer; KeySym *keysym_return; XComposeStatus *status_in_out;
|event_struct||Specifies the key event structure to be used. You can pass XKeyPressedEvent or XKeyReleasedEvent .|
|buffer_return||Returns the translated characters.|
|bytes_buffer||Specifies the length of the buffer. No more than bytes_buffer of translation are returned.|
|keysym_return||Returns the KeySym computed from the event if this argument is not NULL.|
|status_in_out||Specifies or returns the XComposeStatus structure or NULL.|
If present (non-NULL), the XComposeStatus structure records the state, which is private to Xlib, that needs preservation across calls to XLookupString() to implement compose processing. The creation of XComposeStatus structures is implementation dependent; a portable program must pass NULL for this argument.
XLookupString() depends on the cached keyboard information mentioned in the previous section, so it is necessary to use XRefreshKeyboardMapping() to keep this information up-to-date.