shishi_realm_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

💖 NAME 💖

okay bestie, gather round — this is shishi_realm_default_set, an API function from the shishi manual (section 3, the library-call girlies ✨). it sets your default realm. that's the whole vibe. 🎀

✨ SYNOPSIS ✨

#include <shishi.h>

void shishi_realm_default_set(Shishi * handle, const char * realm);

like. it returns void. it does not want your feedback. it just does the thing. 💅

🫶 ARGUMENTS 🫶

  • Shishi * handle — the Shishi library handle, and no you cannot just manifest one out of thin air, it's created by shishi_init(). 🌸
  • const char * realm — a string stating a new default realm name, or NULL. that's it. that's the whole parameter. it's giving simple, it's giving clean. 🦋

💜 DESCRIPTION 💜

so what does it do? it sets the default realm used by the library. periodt. 👑

or — and this is the fun part — if you pass realm as NULL, it resets the library realm setting back to that name selected by configuration for default value. so it's like a little "undo my nonsense, take me back to factory settings" button. no cap. 🔥

and here's the detail that lowkey saves your life: the string is copied into the library. so you can dispose of the content in realm immediately after calling this function. like, right after. don't hold onto it, don't stress about it, don't keep it alive for no reason. she has her own copy now. she's fine. 🧚

😭 REPORTING BUGS 😭

found a bug? first of all, not the vibe, second of all — report bugs to <bug-shishi@gnu.org>. 📧

they wanna hear from you fr fr. 🙈

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. so like. share it, remix it, just keep the receipts. iconic behaviour only. ✨

⭐ SEE ALSO ⭐

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

info shishi

should give you access to the complete manual. iykyk — go read the whole thing, it's a whole journey. 📚

and that's the page bestie!! this was the shishi manual, version 1.0.3, and the page is shishi_realm_default_set(3) — go forth and set your realms responsibly, mwah 💅💖🎀

📦 where this page comes from