mtext_ins(3m17n)

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

💖 mtext_ins — the m17n library, bestie edition 💖

okay so this one's from the m17n Library manual, section 3m17n, and it's genuinely one of my faves because it's just "put this text inside that text" and honestly? iconic. ✨

✨ SYNOPSIS ✨

int mtext_ins (MText * mt1, int pos, MText * mt2)

🦋 DESCRIPTION 🦋

so the mtext_ins() function inserts one M-text into another M-text. no cap. it takes M-text mt2 and drops it into M-text mt1, right at position pos. 💅

and the way that mt1 gets lengthened by the length of mt2? math. slay. 🔥

on insertion, all the text properties of mt2 are inherited — so your formatting, your properties, all of it comes along for the ride. and the original mt2? not modified. not touched. not even a little. it stays exactly as it was, main character untouched energy. 👑

⭐ RETURN VALUE ⭐

  • if the operation was successful, mtext_ins() returns 0. 🫶
  • otherwise, it returns -1 and assigns an error code to the external variable merror_code. 😭

💀 ERRORS 💀

  • MERROR_RANGE
  • MERROR_MTEXT

🌸 SEE ALSO 🌸

  • mtext_del()
  • mtext_insert()

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 bestie that's the whole page 💜 this was Version 1.8.4, dated Mon Sep 25 2023, and it's literally giving mtext_ins(3m17n). go insert something into something else. iykyk 🧚✨

📦 where this page comes from