tcl::tra...rm::core(n)

💖 tcl::tra...rm::core(n) 💖

ok so bestie, welcome to tcl::tra...rm::core(n) — that's the Reflected/virtual channel support corner of the tcllib man pages, and honestly? it's giving foundational. it's the little engine that every single reflected channel transform lowkey depends on. no cap. 🎀

---

✨ NAME ✨

tcl::transform::core — Basic reflected/virtual channel transform support 💅

---

🌸 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 🦋

The tcl::transform::core package hands you a TclOO class that implements the common behaviour that literally every reflected or virtual channel transformation needs — think initialization and finalization. the basics, the vibes, the essentials. 🫶

This class expects to be used as either the superclass of a concrete channel class, or mixed into such a class. it's flexible like that, it's a team player, it's the supportive bestie of the class hierarchy. 🌈

---

👑 CLASS API 👑

• ::tcl::transform::core objectName — This command creates a new transform core object with an associated global Tcl command whose name is objectName. That command is your main character moment: you use it to invoke various operations on the object, as described in the Instance API section below. periodt.

---

🧚 INSTANCE API 🧚

The API of transform core instances gives you only two methods, and both of them correspond to transform handler commands (for reference, see 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 standard behaviour for the initialize method of transform handlers. Using introspection it finds the handler methods supported by the instance and returns a list containing their names, exactly as expected by the support for reflected transformation in the Tcl core. it further remembers the channel handle in an instance variable so sub-classes can access it later. cute, useful, iconic. 💖
• objectName finalize thechannel — This method implements standard behaviour for the finalize method of channel handlers. It simply destroys itself. that's it. that's the method. slay. 💀
• objectName destroy — Destroying the transform core instance closes the channel and transform it was initialized for, see the method initialize. When it's destroyed from within a call of finalize this does not happen — under the assumption that the channel and transform are being destroyed by Tcl itself. important caveat, bestie, don't skip it. 🙈

---

😭 BUGS, IDEAS, FEEDBACK 😭

This document, and the package it describes, will undoubtedly contain bugs and other problems. we know, we know, it's a whole thing. Please report such in the category virtchannel of the Tcllib Trackers at http://core.tcl.tk/tcllib/reportlist. Please also report any ideas for enhancements you may have for either the package and/or the documentation — the glow-up suggestions are welcome fr fr. 🌟

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

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. yes, that specific button. left-most. 🎯

---

🔥 KEYWORDS 🔥

reflected channel, tip 219, virtual channel

---

🌈 CATEGORY 🌈

Channels

---

💜 COPYRIGHT 💜

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

---

ok that's the whole page bestie, you ate it. 🍓 this was tcl::tra...rm::core(n) from tcllib, version 1.1, and yes the manual name up top was Reflected/virtual channel support — now go initialize something and finalize it responsibly. bye bestie 💅✨🎀