VistaIOSetProgramName(3)

💖 VistaIOSetProgramName(3) 💖

okay bestie, listen up — we're in the Library Functions Manual section and today's main character is VistaIOSetProgramName, the lil function that decides whose name gets dropped in your error messages. it's giving personalized chaos. let's go 🫶

✨ NAME ✨

VistaIOSetProgramName — register a program name for error messages 📛

🎀 SYNOPSIS 🎀

void VistaIOSetProgramName (name)
       VistaIOStringConst name

🌸 ARGUMENTS 🌸

• name — the program's name, as a null-terminated string 🧵 ... OR you pass NULL to say "actually bestie, no program name should be registered, forget I said anything" 🙈

🦋 DESCRIPTION 🦋

so here's the tea ☕: VistaIOSetProgramName decides what, if anything, program name gets baked into the error messages that come later. specifically the ones composed by VistaIOError(3), VistaIOSystemError(3), VistaIOWarning(3), and VistaIOSystemWarning(3). it's the vibe-setter for your error output, fr fr 💅

at the very start, no program name is registered. like, blank slate, clean girl aesthetic ✨. but if you call VistaIOSetProgramName with a string, boom 💥 that string is now THE registered program name. iconic.

and if you call VistaIOSetProgramName with an argument of NULL? any previously-registered name is forgotten. memory wiped, no cap, she's gone 💀

🌈 EXAMPLES 🌈

int main (argc, argv)
int argc;
char *argv[];
{
     ...
     VistaIOSetProgramName (argv[0]);
     ...
}

⭐ SEE ALSO ⭐

VistaIOError(3), VistaIOWarning(3), VistaIOSetErrorHandler(3), VistaIOSetWarningHandler(3),

💜 NOTES 💜

⚠️ IMPORTANT ONE, don't skip this bestie: VistaIOSetProgramName does not make its own copy of the string it is passed. consequently, storage used for the string must be maintained by the caller. so like... don't let that buffer die on you, or you're gonna have a bad time 😭 keep it alive, keep it valid, keep it slaying 🔥

👑 AUTHOR 👑

Art Pope <pope@cs.ubc.ca>

Adaption to vistaio: Gert Wollny <gw.fossdev@gmail.com>

aaaand that's the whole page, bestie 🎀 this was VistaIO Version 1.2.14, dated 24 April 1993, and honestly? she ate. periodt 💅✨🦋