tcl::chan::cat(n)

🐱 tcl::chan::cat — the concatenation channel, bestie 💖

okay so this is the man page for tcl::chan::cat, part of the Reflected/virtual channel support crew in Tcllib. it's giving "glue several channels together and pretend they're one" energy and honestly? iconic. ✨

---

✨ SYNOPSIS ✨

package require Tcl 8.5 9

package require TclOO

package require tcl::chan::core ?1.1?

package require tcl::chan::cat ?1.0.4?

::tcl::chan::cat chan...

like yes she needs Tcl 8.5 9, yes she needs TclOO (we love an OO girly), and yeah she's leaning on tcl::chan::core ?1.1? 🫶

---

💅 DESCRIPTION 💅

so the tcl::chan::cat package hands you a command that makes concatenation channels. what's that? it's a channel that is non-seekable and it owns a whole list of subordinate channels, and it returns their contents in order, one after another, until every single one of them is exhausted. so basically the channel is the concatenation of the contents of all the sub-ordinate channels. no cap. 💖

⚠️ okay bestie, listen, this part matters: the created channels take ownership of the channels they were constructed with. whenever they've exhausted one of their channels, it gets closed. and same energy the other way — closing the cat channel will close all the sub-ordinates it still has. she's not borrowing your stuff, she's adopting it. 🫶

the internal TclOO class that implements the channel handler is a sub-class of the tcl::chan::core framework. cute little family tree. 🌸

event handling? delegated to the currently active sub-channel. she's not doing it herself, she's passing the aux. 😭

---

🎀 API 🎀

• ::tcl::chan::cat chan... — this command creates the concatenation channel using all the channels you hand it, and returns its handle. that's it, that's the whole API, she's lowkey simple and we love that for her. ✨

---

🦋 BUGS, IDEAS, FEEDBACK 🦋

ngl, this document and the package it describes will undoubtedly contain bugs and other problems. 💀 please report them in the category virtchannel of the Tcllib Trackers at [http://core.tcl.tk/tcllib/reportlist]. and please also send any ideas for enhancements you may have for either the package and/or the documentation. we're listening fr fr. 🙈

when you're proposing code changes, please provide unified diffs, i.e. the output of diff -u. periodt. 💅

also note: attachments are strongly preferred over inlined patches. you can attach stuff by going to the Edit form of the ticket immediately after you create it, and then using the left-most button in the secondary navigation bar. iykyk. 🎀

---

👑 KEYWORDS 👑

• concatenation channel
• reflected channel
• tip 219
• virtual channel

---

🌈 CATEGORY 🌈

Channels

---

💜 COPYRIGHT 💜

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

---

and that's the whole page bestie, tysm for reading 💖 this was tcllib, version 1.0.4, from the tcl::chan::cat(n) era of 2011 — slay, mwah 💅✨🌸