mconv_stream_converter(3m17n)

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

✨ mconv_stream_converter ✨

okay bestie, welcome to the mconv_stream_converter page from the m17n Library man pages 💖 this one's short and sweet and honestly kind of iconic.

🌸 NAME 🌸

mconv_stream_converter — bestie this section is literally empty in the original, so we're just gonna say hi to the function name and move on 🫶 (the actual tea is all in DESCRIPTION, iykyk)

🎀 SYNOPSIS 🎀

MConverter* mconv_stream_converter (MSymbol name, FILE * fp)

💅 DESCRIPTION 💅

So the whole vibe here is: you're making a code converter that's tied to a stream. 🔥

The mconv_stream_converter() function creates a pointer to a code converter for the coding system called name. That converter is bound to the stream fp. And like — every decoding and encoding after that happens to/from that stream. it's giving committed relationship, no cap. 💞

Now here's the cute part: name can be Mnil. In that case, a coding system associated with the current locale (LC_CTYPE) gets used instead. so if you don't feel like choosing, the locale chooses for you. main character behaviour honestly 👑

🌈 RETURN VALUE 🌈

  • If the operation was successful, mconv_stream_converter() returns the created code converter. slay. ✨
  • Otherwise it returns NULL and assigns an error code to the external variable merror_code. not the vibe, but okay, at least it tells you why 😭

💀 ERRORS 💀

  • MERROR_SYMBOL
  • MERROR_CODING
fr fr, check merror_code when you get NULL back — that's your only clue and you're gonna want it.

🦋 SEE ALSO 🦋

  • mconv_buffer_converter() — the buffer-bound sibling, go say hi 🫶

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>.

okay that's the whole page, bestie, we ate 🍓💅 and just so you know exactly which version of this lore you're reading: this was Version 1.8.4, dated Mon Sep 25 2023, and the page is mconv_stream_converter(3m17n). periodt. 💜🧚‍♀️

📦 where this page comes from