mtext_ins_char(3m17n)

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

✨ mtext_ins_char ✨

okay bestie, welcome to the m17n library docs 💖 this one is a function page, and honestly? it's giving "tiny function, big feelings". let's get into it.

🌸 NAME 🌸

mtext_ins_char — the character-inserting girlie of the m17n family 🎀 (yes, the one-line description is literally empty in the original, and we respect the mysterious main character energy 👑)

🦋 SYNOPSIS 🦋

int mtext_ins_char (MText * mt, int pos, int c, int n)

💅 DESCRIPTION 💅

so here's the vibe: this function inserts a character into an M-text. no cap.

The mtext_ins_char() function inserts n copies of character c into M-text mt at position pos. As a result, mt is lengthen by n.

like, literally n copies. not one. not "a couple". n. and yeah the original says "lengthen" and we are not touching that, it's part of the lore 💀

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

🚨 wait bestie — yes, the original really does say mtext_ins() here and not mtext_ins_char(). we are preserving that exactly, fr fr. do not @ me, I don't make the rules 🙈

😭 ERRORS 😭

  • MERROR_RANGE

that's the whole list. one error. she's focused ✨

🫶 SEE ALSO 🫶

  • mtext_ins
  • mtext_del()

go read those next, they're the sibling besties of this function 🌈

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 page!! 💜 this was Version 1.8.4, dated Mon Sep 25 2023, and it lives in the m17n manual (section 3, 3m17n) 🎀 slay, go insert some characters, ily 🦋

📦 where this page comes from