tcl::chan::fifo(3tcl)

✨ tcl::chan::fifo ✨

okay bestie, gather round, because this one is genuinely adorable and it lives entirely in your RAM 💖 this is tcl::chan::fifo from the Tcllib Reflected/virtual channel support crew, and yes, the manual page name is literally tcl::chan::fifo(3tcl) in case you needed that for your notes 📝

---

🌸 SYNOPSIS 🌸

package require Tcl 8.5 9

package require TclOO

package require tcl::chan::events ?1.1?

package require tcl::chan::fifo ?1.1?

::tcl::chan::fifo

---

🦋 DESCRIPTION 🦋

so the tcl::chan::fifo package hands you a command that makes channels, except — plot twist — these channels live purely in memory ✨ no disk, no filesystem, no drama, just vibes.

access is fifo-like, which is the whole point: things come out of the channel in exactly the order they went in. first in, first out. the way that it's literally just a line at the boba shop 🧋 no cutting, bestie, we respect the queue.

this is equivalent to the fifo channels that the package Memchan provides, except this one is written in pure Tcl, not C 💅 and here's the tradeoff, because there always is one: Memchan is usable with Tcl 8.4 and before, whereas this package requires Tcl 8.5 or higher, and TclOO. so if you're on ancient Tcl, Memchan is your girl. if you're modern and you want the pure-Tcl vibe, welcome home 🫶

the internal TclOO class implementing the channel handler is a sub-class of the tcl::chan::events framework. icon behaviour, honestly 👑

---

💜 API 💜

• ::tcl::chan::fifo — this command creates a new fifo channel and returns its handle. that's it, that's the whole API, she's simple and she knows what she wants 💖

---

😭 BUGS, IDEAS, FEEDBACK 😭

ngl, this document, and the package it describes, will undoubtedly contain bugs and other problems. it's giving "we're all doing our best" 🙈 so please report such things in the category virtchannel of the Tcllib Trackers at http://core.tcl.tk/tcllib/reportlist. and please also report any ideas for enhancements you may have for either the package and/or the documentation — we want them, fr fr 🫶

when proposing code changes, please provide unified diffs, i.e. the output of diff -u. not vibes, not screenshots, the actual diff 🙏

also note further that attachments are strongly preferred over inlined patches. attachments can be made by going to the Edit form of the ticket immediately after its creation, and then using the left-most button in the secondary navigation bar. iykyk 💅

---

🎀 KEYWORDS 🎀

fifo, in-memory channel, reflected channel, tip 219, virtual channel

---

🌈 CATEGORY 🌈

Channels

---

👑 COPYRIGHT 👑

Copyright (c) 2009 Andreas Kupries <andreas_kupries@users.sourceforge.net>

---

okay that's the whole page, bestie, you're officially fluent in in-memory fifo channels 💖 this was tcllib version 1.1 of tcl::chan::fifo(3tcl), and yes, the footer date and version line is exactly that — tcllib, 1.1, and the page itself. slay, go make some channels 🧚✨