tcl::t...observe(3tcl)

✨ tcl::t...observe(3tcl) ✨

okay bestie, buckle up 💖 this is the manual page for tcl::transform::observe, living in the Reflected/virtual channel support corner of the tcllib universe. no cap, it's a lil cutie.

---

🌸 NAME 🌸

tcl::transform::observe — Observer transformation, stream copy 🦋

---

✨ SYNOPSIS ✨

package require Tcl 8.6 9

package require tcl::transform::core ?1.1?

package require tcl::transform::observe ?1.1?

::tcl::transform::observe chan logw logr

---

💅 DESCRIPTION 💅

so the tcl::transform::observer package hands you a command that makes a channel transformation. and what does that transformation do? it lets the read and written bytes pass right on through, totally unchanged — literally just like tcl::transform::identity does — but 👀 it also copies all the data it has seen, for each direction, into channels you specify when you construct it. it's giving "main character who takes notes on everything" energy. 📝

the related transformations hanging out in this same module are tcl::transform::adler32, tcl::transform::counter, tcl::transform::crc32, and tcl::transform::identity. squad goals fr fr 🫶

and just so you know: the internal TclOO class that actually implements the transform handler is a subclass of the tcl::transform::core framework. iconic lineage, honestly. 👑

---

🌈 API 🌈

• ::tcl::transform::observe chan logw logr — this command creates an observer transformation on top of the channel chan and returns its handle. the channel handles logr and logw are where the data gets copied to. that's it, that's the whole vibe ✨

---

😭 BUGS, IDEAS, FEEDBACK 😭

ngl, this document — and the package it describes — will undoubtedly contain bugs and other problems. like, obviously. so please report them in the category virtchannel of the Tcllib Trackers at [http://core.tcl.tk/tcllib/reportlist]. and please also report any ideas for enhancements you have for either the package and/or the documentation. we want the glow-up ideas too 💖

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

also note: attachments are strongly preferred over inlined patches. you can 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 👑

channel transformation, observer, reflected channel, stream copy, tip 230, transformation, virtual channel

---

🦋 CATEGORY 🦋

Channels

---

💜 COPYRIGHT 💜

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

---

and that's the whole page, bestie 🫶 this was tcllib, version 1.1, of the tcl::t...observe(3tcl) manual — slay, go copy some streams, mwah 💅✨