mtext_serialize(3m17n)

✨ mtext_serialize — the m17n library's lil XML glow-up for your text properties 💖

okay bestie, welcome to mtext_serialize(3m17n) from The m17n Library 🎀 pull up a chair, we're about to turn your fancy text properties into XML and honestly? it's giving archival queen 👑

---

🌸 NAME 🌸

mtext_serialize — serialize text properties in an M-text ✨

---

🦋 SYNOPSIS 🦋

MText* mtext_serialize (MText * mt, int from, int to, MPlist *
       property_list)

---

💅 DESCRIPTION 💅

okay so the whole vibe here is: serialize text properties in an M-text. that's the tea. 🍵

The mtext_serialize() function serializes the text between from and to in the M-text mt. and the result? an M-text in the form of XML bestie, we're fancy now 💖

property_list is the bouncer at the club 🚪 — it limits which text properties get serialized. Only those text properties whose key does BOTH of these get in:

• appears as the value of an element in property_list, and
• has the symbol property #Mtext_prop_serializer

...and only those get serialized as a "property" element in the resulting XML representation. no invite, no entry, periodt 💅

---

🎀 The DTD of the generated XML 🎀

here's the whole fit, exactly as it comes out:

<!DOCTYPE mtext [
  <!ELEMENT mtext (property*,body+)>
  <!ELEMENT property EMPTY>
  <!ELEMENT body (#PCDATA)>
  <!ATTLIST property key CDATA #REQUIRED>
  <!ATTLIST property value CDATA #REQUIRED>
  <!ATTLIST property from CDATA #REQUIRED>
  <!ATTLIST property to CDATA #REQUIRED>
  <!ATTLIST property control CDATA #REQUIRED>
 ]>

---

🚨 ok real talk for a sec bestie: this function depends on the libxml2 library. If the m17n library is configured without libxml2, this function always fails. no libxml2, no XML. it's that simple 😭

---

⭐ Return value ⭐

if everything slayed: mtext_serialize() returns an M-text in the form of XML 🎉

if not: it returns NULL and assigns an error code to the external variable #merror_code. sad girl hours 🙈

---

🫶 See Also 🫶

• mtext_deserialize() — the reverse glow-up 🔄
• #Mtext_prop_serializer — the symbol that decides who gets serialized 👑

---

👑 COPYRIGHT 👑

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, no cap 💜 this was Version 1.8.4, dated Mon Sep 25 2023, and it lives under the name mtext_serialize(3m17n) — mwah, go forth and serialize, ily 🦋✨💖