NAME

       XkbTranslateKeySym - Find the string and symbol associated with a keysym for a given keyboard state

SYNOPSIS

       int  XkbTranslateKeySym  (Display  *dpy, KeySym *sym_inout, unsigned int mods, char *buf, int nbytes, int
              *extra_rtrn);

ARGUMENTS

       - dpy  connection to X server

       - sym_inout
              symbol to be translated; result of translation

       - mods modifiers to apply to sym_inout

       - buf  buffer into which returned string is written

       - nbytes
              size of buffer in bytes

       - extra_rtrn
              number of bytes overflow

DESCRIPTION

       XkbTranslateKeySym applies the transformations specified in mods to the symbol  specified  by  sym_inout.
       It  returns  in  buf  the  string,  if  any,  associated  with  the keysym for the current locale. If the
       transformations in mods changes the keysym, sym_inout is updated accordingly. If the string  returned  is
       larger  than  nbytes,  a  count  of  bytes  that  does not fit into the buffer is returned in extra_rtrn.
       XkbTranslateKeySym returns the number of bytes it placed into buf.

RETURN VALUES

       buf            Returns the string, if any, associated with the keysym for the current locale.