shishi_tkts_default_file_guess(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_tkts_default_file_guess(3) 💖

okay bestie, welcome to the shishi manual, section 3 (that's library calls, iykyk). this one is literally just about guessing where your tickets live. no cap, that's the whole vibe. 🎫✨

✨ NAME ✨

shishi_tkts_default_file_guess — API function

🌸 SYNOPSIS 🌸

#include <shishi.h>

char * shishi_tkts_default_file_guess(Shishi * handle);

like. one function. one arg. we love a low-maintenance icon. 💅

🎀 ARGUMENTS 🎀

  • Shishi * handle — the Shishi library handle, and you get it by calling shishi_init(). that's it, that's the whole requirement. create it first or this is giving nothing. 🫶

🦋 DESCRIPTION 🦋

so what does she do? she guesses the default ticket filename. that's the job. and the way she guesses is very much a priority list, in this exact order:

  1. $SHISHI_TICKETS
  2. $SHISHI_HOME/tickets
  3. $HOME/.shishi/tickets

that's it bestie, that's the whole algorithm. she checks the environment, she checks the fallbacks, she picks one. ⭐

👑 RETURN VALUE 👑

she returns the default tkts filename as a string. and listen — this string is yours now. the caller has to deallocate it with free(). not optional. if you don't free() it you're leaking memory and the vibe check has failed. 😭💀

🙈 REPORTING BUGS 🙈

found something cursed? report bugs to <bug-shishi@gnu.org>. 📧

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. (translation: go forth and share, just keep the receipts.)

🌈 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. go read it, it's the main character of docs. 📚✨

okay that's the whole page, ty for coming to my ted talk 💖 this was shishi version 1.0.3, and yeah, the page is literally titled shishi_tkts_default_file_guess(3) — mwah, slay, periodt. 🎀🦋🌸

📦 where this page comes from