XMIMGETXIM(3)

πŸ“¦
version 2.5.2 Β· 2 versions
, in alpine 3.24, arch rolling, centos-stream 9, epel 10, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0

πŸ’– XMIMGETXIM πŸ’–

okay bestie, welcome to the XmImGetXIM page β€” it's a library call from the Motif input-manager girlies, and yes it lives in the manual under <lavender>XmImGetXIM(library call)</lavender> iykyk ✨


✨ NAME ✨

XmImGetXIM β€” an input manager function that retrieves the input method associated with a specified widget πŸŽ€


🌸 SYNOPSIS 🌸

#include <Xm/XmIm.h>
XIM XmImGetXIM(
Widget widget);

πŸ¦‹ DESCRIPTION πŸ¦‹

so what does she do? XmImGetXIM retrieves the XIM data structure that represents the input method the input manager has opened for the widget you point at πŸ‘‘

and here's the tea: if an input method has not been opened by a previous call to XmImRegister, then the first time this routine gets called, it opens an input method for you β€” using the XmNinputMethod resource for the VendorShell 🌈

and if XmNinputMethod is NULL? no stress, she just opens an input method using the current locale πŸ’…

and if she can't open an input method at all? πŸ’€ she returns NULL. that's it. that's the whole mood.

  • widget β€” specifies the ID of a widget registered with the input manager 🫢

πŸ‘‘ RETURN πŸ‘‘

she returns the input method for the current locale associated with the specified widget's input manager πŸ’–

otherwise? NULL. simple as that.

⚠️ and listen β€” the application is responsible for freeing the returned XIM by calling XmImCloseXIM. that's on you, not her. don't forget, bestie 😭

the whole friend group fr fr 🫢


and that's the page!! XmImGetXIM(library call) β€” that's literally the title and the footer both, iconic, no notes πŸ’…βœ¨ go open an input method, main character πŸŒΈπŸ’œ