mtext_coll(3m17n)

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

✨ NAME ✨

mtext_coll -

okay so bestie, the NAME section is literally just vibes and a dash, that's it, that's all the manpage gave us 😭 the rest of the tea is down below 💅

🌸 SYNOPSIS 🌸

int mtext_coll (MText * mt1, MText * mt2)

🦋 DESCRIPTION 🦋

okay so picture this: you got two M-texts and you need to know which one comes first, right? mtext_coll() is the girl for that job. She compares the two M-texts mt1 and mt2, using the current locale — like, the actual rules your system is living by right now.

And what does she hand back? An integer, bestie:

  • an integer less than zero → mt1 is found to be less than mt2
  • an integer equal to zero → mt1 matches mt2
  • an integer greater than zero → mt1 is found to be greater than mt2

And the comparison itself? It's based on texts as appropriate for the current locale, specifically LC_COLLATE. no cap, that's the whole rule 👑

🧚 now here's the lil secret that makes her fast: this function makes use of information that is automatically cached in the M-texts as a text property. So the second call of this function with mt1 or mt2 finishes faster than the first call. she remembers. she's efficient. she ate 💅✨

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, you're officially educated 🎀 this was Version 1.8.4, dated Mon Sep 25 2023, from the m17n manual — mwah, go forth and collate 💖🦋🌈

📦 where this page comes from