mtext_get_prop_values(3m17n)

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

💖 mtext_get_prop_values 💖

okay bestie, welcome to the m17n Library manual, page mtext_get_prop_values(3m17n). yes this is a real function and yes it's lowkey iconic. let's get into it ✨

🎀 NAME 🎀

mtext_get_prop_values -

(no cap, the original page leaves the description blank. we respect the blank. the blank is the vibe.)

🌸 SYNOPSIS 🌸

int mtext_get_prop_values (MText * mt, int pos, MSymbol key, void **
values, int num)

🦋 DESCRIPTION 🦋

okay so picture this: you want multiple values of a text property. not one. MULTIPLE. main character energy fr.

The mtext_get_prop_values() function searches the character at pos in M-text mt for the property whose key is key. slay.

If such a property is found, its values are stored in the memory area pointed to by values. 💅

And num limits the maximum number of stored values. that's the cap. literally the cap. don't exceed it.

✨ RETURN VALUE ✨

  • If the operation was successful, mtext_get_prop_values() returns the number of actually stored values. 🫶
  • If the character at pos does not have a property whose key is key, the return value is 0. (it's giving "nothing here bestie")
  • If an error is detected, mtext_get_prop_values() returns -1 and assigns an error code to the external variable merror_code. 😭

💀 ERRORS 💀

  • MERROR_RANGE, MERROR_SYMBOL

🔥 SEE ALSO 🔥

  • mtext_get_prop()
  • mtext_put_prop()
  • mtext_put_prop_values()
  • mtext_push_prop()
  • mtext_pop_prop()
  • mtext_prop_range()

go read those too, iykyk 👑

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 whole page bestie, you ate it 💖

Version 1.8.4 · Mon Sep 25 2023 · and we were all hanging out on mtext_get_prop_values(3m17n) the whole time 🎀✨ mwah, bye!! 🦋💜

📦 where this page comes from