VistaIODecodeAttrValue(3)

📦 version 1.2.19, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 VistaIODecodeAttrValue(3) 💖

okay bestie, welcome to the Library Functions Manual — today's main character is VistaIODecodeAttrValue(3), and she is literally here to turn your dusty little string into a real, typed value. no cap. 🎀

✨ NAME ✨

VistaIODecodeAttrValue — decode an attribute value 🦋

🌸 SYNOPSIS 🌸

VistaIOBoolean VistaIODecodeAttrValue (str, dict, repn, value)
       VistaIOStringConst str;
       VistaIODictEntry *dict;
       VistaIORepnKind repn;
       VistaIOPointer value;

🎀 ARGUMENTS 🎀

  • str — the attribute value you want decoded, bestie. hand it over. 💅
  • dict — this may specify a dictionary used to recognize the value you passed as a keyword. or it may just be NULL. either way she's unbothered. 🙈
  • repn — the representation you want the value returned in. it must be one of VistaIOBitRepn, VistaIOUByteRepn, VistaIOSByteRepn, VistaIOShortRepn, VistaIOLongRepn, VistaIOFloatRepn, VistaIODoubleRepn, VistaIOBooleanRepn, or VistaIOStringRepn. that's the whole guest list, no plus-ones. ✨
  • value — a location where the value is to be returned. she's putting it right there. 🫶

💜 DESCRIPTION 💜

VistaIODecodeAttrValue decodes the string str and returns its value in the form you specified with repn. it's giving translator, it's giving glow-up for strings. 🔥

If a dictionary — dict — has been provided, the routine figures out whether str is a keyword defined in that dictionary. and if it is? she uses the value associated with that keyword instead of the attribute's original value. (peep the VistaIOdictionary(3) manual page for the lore. 📖)

The value obtained directly from str, or indirectly via the dictionary, gets converted to the representation repn and then stored at the location pointed to by value. slay. 👑

⭐ RETURN VALUES ⭐

VistaIODecodeAttrValue returns TRUE if it succeeded and FALSE otherwise.

She will fail if repn is invalid, or if str cannot be interpreted as a value of the type indicated by repn. like, she tried, okay? 😭

🌈 SEE ALSO 🌈

💀 NOTES 💀

The value argument must point to sufficient storage to contain a value of the representation requested. Neither VistaIODecodeAttrValue nor the C compiler can automatically check that this is so. 🚨

fr fr, she is NOT checking your buffer for you. that's on you, bestie. no cap. 🫣

🩺 DIAGNOSTICS 🩺

  • `Can't decode to repn.'` — this means the repn argument is not one of VistaIOBitRepn, VistaIOUByteRepn, ..., VistaIOBooleanRepn, or VistaIOStringRepn. wrong rep, boo. 💅

👑 AUTHOR 👑

  • Art Pope <pope@cs.ubc.ca>
  • Adaption to vistaio: Gert Wollny <gw.fossdev@gmail.com>

and that's the whole page, gorgeous ✨ this was VistaIO Version 1.2.14, dated 24 April 1993 — yeah she's vintage but she still ate. periodt. 💖🎀🦋

📦 where this page comes from