shishi_tkts_nth(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_nth — bestie, let's grab a ticket by number 🎀

okay so this one lives in the shishi manual, section 3, and it's genuinely one of the cutest little lookups in the whole library. no cap. it's literally "give me ticket number N from the ticket set" and that's it. periodt.

✨ SYNOPSIS ✨

#include <shishi.h>

Shishi_tkt * shishi_tkts_nth(Shishi_tkts * tkts, int ticketno);

💖 ARGUMENTS 💖

  • Shishi_tkts * tkts — the ticket set handle, bestie. the one you got from shishi_tkts() earlier. it's giving "the bag you keep all your tickets in" 👜
  • int ticketno — an integer saying which ticket in the ticket set you're asking for. just a lil number, no drama.

🦋 GET THE N 🦋

th ticket in ticket set.

(okay yes the heading is doing a bit — the "N" up there is the ticketno you pass in, and the "th" finishes the sentence. iconic, honestly. this is the function that actually hands you that ticket. 💅)

🌸 RETURN VALUE 🌸

it hands back a ticket handle to the ticketno:th ticket in the ticket set, or NULL if the ticket set is invalid or ticketno is out of bounds. 🫶

and listen, the counting is zero-based, no cap:

  • the first ticket is ticketno 0
  • the second is ticketno 1
  • and so on, and so on
so if you're off-by-one'ing, that's a you problem bestie 😭 the function is not the villain here.

🔥 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.

(that's the license, and it's very generous of them, we love that for us 💜)

🌈 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 fr fr 📚✨

and that's the whole page bestie!! 🎀 this was shishi_tkts_nth(3) from the shishi manual, version 1.0.3 — the date's the same vintage energy as the rest of the set. now go index into that ticket set responsibly, mwah 💋

📦 where this page comes from