tcl::chan::zero(3tcl)

💖 tcl::chan::zero — the zero channel 💖

okay bestie, welcome to tcl::chan::zero(3tcl), from the Reflected/virtual channel support family of manual pages. sit down, grab a strawberry 🍓, we're talking about a channel that will literally read forever and give you nothing but nulls. it's giving ✨the void✨ and honestly? iconic.

---

🎀 NAME 🎀

tcl::chan::zero — zero channel. that's it, that's the name, no notes. 💅

---

✨ SYNOPSIS ✨

package require Tcl 8.5 9

package require TclOO

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

package require tcl::chan::zero ?1.1?

::tcl::chan::zero

the little ?1.1? means the version is optional to specify, bestie — it's not a question mark of confusion, it's a question mark of flexibility. 🦋

---

🌸 DESCRIPTION 🌸

so the tcl::chan::zero package gives you a command that makes zero channels. and what's a zero channel, you ask? it's a read-only channel that, when you read from it, hands you an infinite stream of null characters. infinite. stream. nulls. it just keeps going. main character energy but make it nothing. 💀

it's the exact same energy as the zero channels you'd get from the package Memchan — except this one is written in pure Tcl, not C. no cap.

now the tradeoff, because there's always a tradeoff bestie:

• Memchan is usable with Tcl 8.4 and before.
• this package needs Tcl 8.5 or higher, and TclOO. no shortcuts, we need the fancy stuff.

packages that are related to this one, so you know the whole friend group: tcl::chan::null and tcl::chan::nullzero. 🫶

and the internal TclOO class that actually implements the channel handler? it's a sub-class of the tcl::chan::events framework. so it's in the family tree, it just showed up with a cute outfit. 🧚

---

👑 API 👑

• ::tcl::chan::zero — this command creates a brand new zero channel and returns its handle. that's the whole API. one command. one job. ate and left no crumbs. 🔥

---

😭 BUGS, IDEAS, FEEDBACK 😭

not to be dramatic but this document, and the package it describes, will undoubtedly contain bugs and other problems. it's not a vibe check fail, it's just software. please report them in the category virtchannel of the Tcllib Trackers:

http://core.tcl.tk/tcllib/reportlist

also please report any ideas for enhancements you may have, for either the package and/or the documentation. we want them, fr fr. 💖

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

and note, bestie: attachments are strongly preferred over inlined patches. you make an attachment 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 ⭐

/dev/zero, reflected channel, tip 219, virtual channel, zero

---

🌈 CATEGORY 🌈

Channels

---

💜 COPYRIGHT 💜

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

---

and that's the whole page, bestie!! this was tcl::chan::zero(3tcl) from tcllib, version 1.1 — go forth and read infinitely many nulls, you absolute legend. 🎀💖✨