mtext_ncpy(3m17n)

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

💖 mtext_ncpy — the m17n library's lil copy-paste bestie 💖

okay so bestie, this is mtext_ncpy(3m17n), part of the m17n library, and it's literally the "copy exactly this many characters please" function. no cap. it's giving clipboard energy but make it precise. 🎀

✨ SYNOPSIS ✨

MText* mtext_ncpy (MText * mt1, MText * mt2, int n)

🌸 DESCRIPTION 🌸

so what it does is copy the first some characters from one M-text into another. specifically, mtext_ncpy() copies the first n characters of the M-text mt2 into the M-text mt1, and while it does that it inherits all the text properties — yes, all of them, it brings the whole vibe along. 🦋

and if mt2 is shorter than n? no drama, it just copies all the characters of mt2. like, it copies what's there, it doesn't invent characters, that would be wild. 😭

the old text sitting in mt1 gets overwritten (rip to the previous contents fr fr) and the length of mt1 gets extended if it needs to be, so it can actually hold everything.

and mt2? mt2 is not modified. it's just the donor, it walks away untouched, main character energy. 👑

💅 RETURN VALUE 💅

if everything went good, mtext_ncpy() returns a pointer to the resulting M-text mt1. slay. 🫶

if an error gets detected, it returns NULL and assigns an error code to the global variable merror_code. so like, check that. 🙈

💀 ERRORS 💀

  • MERROR_RANGE

🔥 SEE ALSO 🔥

  • mtext_cpy()
  • mtext_copy()

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 bestie, Version 1.8.4, dated Mon Sep 25 2023 — mwah, go copy some characters responsibly 💜✨

📦 where this page comes from