tcl::t...::core(3tcl)

💅 tcl::transform::core — bestie edition (3tcl)

okay so you found the 3tcl manual page for Reflected/virtual channel support and honestly? you're about to have a great time. sit down, grab a boba, let's get into it 🧋✨

---

✨ NAME ✨

tcl::transform::core — the basic reflected/virtual channel transform support, the little backstage bestie that makes everything else work 💖

---

🌸 SYNOPSIS 🌸

package require Tcl 8.5 9

package require TclOO

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

::tcl::transform::core objectName

objectName initialize thechannel mode

objectName finalize thechannel

objectName destroy

---

🦋 DESCRIPTION 🦋

so the tcl::transform::core package hands you a TclOO class that implements the common behaviour that literally every reflected or virtual channel transformation needs — that's the initialization and finalization of it all. the boring-but-essential stuff. the getting-ready-and-getting-out-the-door of channel transforms 🎀

this class expects to be used one of two ways, and it's very chill about it:

• as the superclass of a concrete channel class, or
• mixed into such a class 💫

either way, it's giving teamwork.

---

👑 CLASS API 👑

• ::tcl::transform::core objectName — this command creates a brand new transform core object, and that object comes with a global Tcl command attached whose name is objectName. you use that command to invoke the various operations on the object, all described down in the Instance API section. slay 💅

---

🌈 INSTANCE API 🌈

okay so the API of transform core instances is lowkey minimal — only two methods, and both of them correspond to transform handler commands (for reference, go look at TIP 230 at http:/tip.tcl.tk/230). they expect to be called from whichever object instance the transform core was made a part of. iykyk.

• objectName initialize thechannel mode — this method implements the standard behaviour for the initialize method of transform handlers. using introspection it finds all the handler methods that the instance supports and returns a list containing their names, exactly as the support for reflected transformation in the Tcl core expects it. it also remembers the channel handle in an instance variable so that sub-classes can get at it later. very thoughtful of it, honestly 🫶
• objectName finalize thechannel — this method implements the standard behaviour for the finalize method of channel handlers. and what does it do? it simply destroys itself. iconic. no drama. 💀
• objectName destroy — destroying the transform core instance closes the channel and transform it was initialized for, see the initialize method. but — and this is the important part, bestie, listen — when it's destroyed from within a call of finalize, that does not happen, under the assumption that the channel and transform are already being destroyed by Tcl. don't be the person who double-destroys. 🙈

---

😭 BUGS, IDEAS, FEEDBACK 😭

real talk: this document, and the package it describes, will undoubtedly contain bugs and other problems. it's not a vibe, it's just reality. please report them in the category virtchannel of the Tcllib Trackers: http://core.tcl.tk/tcllib/reportlist. and while you're there, please also report any ideas for enhancements you may have for either the package and/or the documentation. we love ideas here 💜

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

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. that's the whole recipe, no cap 🍓

---

🔥 KEYWORDS 🔥

reflected channel, tip 219, virtual channel

---

💖 CATEGORY 💖

Channels

---

🌸 COPYRIGHT 🌸

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

---

and that's the whole page bestie!! no notes, ate, periodt 👑

okay so this was tcllib, version 1.1, and the page is tcl::t...::core(3tcl) — thanks for reading, mwah 💋✨🦋