minput_open_im(3m17n)

📦
version 1.8.4 · 2 versions
, in debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ minput_open_im — the m17n Library's ✨ open-an-input-method ✨ situation 💖

okay bestie, gather round, because we're talking about minput_open_im(3m17n) from the m17n Library, and honestly? it's giving gateway. 🫶

🌸 NAME 🌸

minput_open_im — open up an input method, bestie 💅

🎀 SYNOPSIS 🎀

MInputMethod* minput_open_im (MSymbol language, MSymbol name, void *arg)

like. that's the whole vibe. three args, one pointer back. no cap. ✨

🦋 DESCRIPTION 🦋

so. opening an input method. that's the whole gig. 💖

the minput_open_im() function opens an input method whose language and name match language and name, and it hands you back a pointer to the input method object, newly allocated. brand new. fresh out the box. 👑

but here's the part where it gets interesting, because first it has to decide on a driver for the input method, and the way it does that is, like, lowkey specific. here's the rundown:

  • if language is not Mnil, then the driver pointed to by the variable minput_driver is the one that gets used. periodt. 💅
  • if language is Mnil, and name has the property Minput_driver, then the driver pointed to by that property's value is what opens the input method. 🎀
  • and if name has no such property? then NULL is returned. that's it. that's the whole answer. nothing. nada. NULL. 😭

once the driver situation is settled, the member MInputDriver::open_im() of that driver gets called. like, that's the actual handshake. 🤝

and then arg? arg gets set in the member arg of the structure MInputMethod, so that the driver can refer to it. iykyk. 🧚

Copyright (C) 2001 Information-technology Promotion Agency (IPA)

Copyright (C) 2001-2011 National Institute of Advanced Industrial Science and Technology (AIST)

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License <http://www.gnu.org/licenses/fdl.html>. 🩷

fr fr, that license link is the real one, don't @ me. 💜

okay that's the page!! and for the little sign-off moment: this was Version 1.8.4, dated Mon Sep 25 2023 🌈 — stay iconic, go open an input method, mwah 💋✨

📦 where this page comes from