mface_get_prop(3m17n)

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

✨ mface_get_prop ✨

okay bestie, so you know the m17n Library? yeah, that one. this is the tea on mface_get_prop(3m17n), and it's genuinely such a useful little function, i'm obsessed 💖

💅 NAME 💅

mface_get_prop — no cap, that's the whole name, it does exactly what it says on the tin

🌸 SYNOPSIS 🌸

void* mface_get_prop (MFace * face, MSymbol key)

🎀 DESCRIPTION 🎀

okay so here's the vibe: mface_get_prop() grabs the value of a face property. you hand it a face, you hand it a key, and it hands you back the value of the face property with that key in that face. simple. iconic. main character behavior fr fr 🦋

but listen, the key has to be one of these, periodt:

  • #Mforeground
  • #Mbackground
  • #Mvideomode
  • #Mhline
  • #Mbox
  • #Mfoundry
  • #Mfamily
  • #Mweight
  • #Mstyle
  • #Mstretch
  • #Madstyle
  • #Msize
  • #Mfontset
  • #Mratio
  • #Mhook_func
  • #Mhook_arg

those are the keys, that's the list, don't try to be cute with something else 💀

⭐ RETURN VALUE ⭐

so what even comes back? the actual type of the returned value depends on key, lowkey. like, it changes based on which key you passed. check the documentation for the above keys to know what you're getting, iykyk 👑

and if something goes wrong — error detected, bestie — it returns NULL and assigns an error code to the external variable merror_code. so yeah, always check your returns, that's the vibe check 🌈

👀 SEE ALSO 👀

  • mface_put_prop()
  • mface_put_hook()

go read those too, they're the besties of this function, they come as a set 🫶

💀 ERRORS 💀

  • MERROR_FACE

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!! thanks for reading all the way to the bottom, you're literally a scholar 💖 this was Version 1.8.4, dated Mon Sep 25 2023, and it ate, no crumbs. byeee ✨🎀

📦 where this page comes from