mconv_buffer_converter(3m17n)

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

💖 mconv_buffer_converter 💖

okay bestie, welcome to the m17n Library corner of the manual pages — this one's mconv_buffer_converter, and it's from section 3m17n (the library-call girlies, you know the vibe). let's get into it 🫶

✨ NAME ✨

mconv_buffer_converter — your girl that spins up a code converter and ties it to a buffer 💅

🌸 SYNOPSIS 🌸

MConverter* mconv_buffer_converter (MSymbol name, const unsigned char *
buf, int n)

🦋 DESCRIPTION 🦋

okay so here's the tea: mconv_buffer_converter() creates a pointer to a code converter for the coding system called name. ✨

and not just any converter — this one is bound to a buffer area</>, specifically the area of n bytes that buf points to. so like, every decoding and encoding that happens after this is done to/from that exact buffer area</>. it's giving committed relationship, no cap 💖

also, name can be Mnil. and if it is? no stress — the coding system associated with the current locale (LC_CTYPE) gets used instead. very "if you don't pick a fit, the locale picks for you" energy 👑

⭐ RETURN VALUE ⭐

  • if everything went slay and the operation was successful, mconv_buffer_converter() hands you back the created code converter 🎀
  • otherwise it returns NULL and assigns an error code to the external variable merror_code. so if you get nothing back, go check merror_code, bestie, it's literally telling you what went wrong 😭

🚨 ERRORS 🚨

  • MERROR_SYMBOL
  • MERROR_CODING
ngl, when these pop up it's a whole vibe check fail — go read merror_code, it knows the whole story 🙈

See Also:

  • mconv_stream_converter()

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

and that's the whole page, periodt 💜 this was Version 1.8.4, dated Mon Sep 25 2023 — so yes, she's from the 2023 era and she ate 🌈✨ go convert some buffers, ily, bye 🎀

📦 where this page comes from