shishi_principal_default_set(3)

📦
version 1.0.3 · 2 versions
  • 1.0.3 · debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 1.0.2 · ubuntu jammy
, in debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 shishi_principal_default_set 💖

okay bestie, so this is a page from the shishi manual — yes, the GNU Shishi one, section 3, the library-call section, iykyk. It's all about shishi_principal_default_set, which is literally an API function, no cap. Pull up a chair, we're doing this together 🫶

✨ NAME ✨

shishi_principal_default_set — it's an API function, bestie. That's the whole vibe. 💅

🌸 SYNOPSIS 🌸

#include <shishi.h>

void shishi_principal_default_set(Shishi * handle, const char *
principal);

like… look at her. void return, two args, living her truth. 🎀

🦋 ARGUMENTS 🦋

  • Shishi * handle — this is your Shishi library handle, the one you got from shishi_init(). Your main character. Your everything. Don't lose her. 👑
  • const char * principal — a string holding the brand new default principal name you want. OR you can pass NULL to reset it back to the default. yes, NULL is the "never mind, factory reset me" option and honestly? valid. 🙈

💜 DESCRIPTION 💜

okay so here's the tea: this function sets the default principal that the library uses. that's it, that's the function.

and here's the cute part — the string is copied into the library, so the literal second after you call this function you can go ahead and dispose of your variable. free her. she's not needed anymore. the library has her now. ✨

it's giving "you can let go" energy fr fr. 😭💖

😤 REPORTING BUGS 😤

found a bug? not the vibe. tell the people who can fix it:

Report bugs to <bug-shishi@gnu.org>.

they will help you, bestie. that's their whole thing. 🫶

Copyright © 2002-2022 Simon Josefsson.

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. slay, open licensing, we love to see it 💚

🌈 SEE ALSO 🌈

the full documentation for shishi is maintained as a Texinfo manual, periodt. and if the info and shishi programs are properly installed at your site, this command:

info shishi

should give you access to the complete manual. go read her. she's thorough. she's iconic. 📚✨

lowkey reminder: this page is version 1.0.3, and it's part of the shishi manual, dated as such, sourced from the shishi project itself. so if you're citing her, that's the receipt. 💅

okay bye bestie, go set some principals, you absolute legend 💖🎀🦋🌸

📦 where this page comes from