tcl::t...spacer(3tcl)

✨ tcl::transform::spacer ✨

okay bestie, welcome to the tcl::transform::spacer page — that's section 3tcl, and it's the reflected/virtual channel support corner of the tcllib world 🫶. Buckle up, it's short but it's mighty.

---

💖 NAME 💖

tcl::transform::spacer — space insertation and removal (yes, "insertation", we keep it exactly as it is, no cap 💅)

---

🦋 SYNOPSIS 🦋

package require Tcl 8.6 9

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

package require tcl::transform::spacer ?1.1?

::tcl::transform::spacer chan n ?space?

---

🌸 DESCRIPTION 🌸

The tcl::transform::spacer package hands you a command that creates a channel transformation. What does that transformation do, you ask? It adds spacing to the data you write to it, and then it removes that same spacing from the data you read from it. Iconic behaviour honestly ✨.

The internal TclOO class that implements the transform handler is a subclass of the tcl::transform::core framework. So like, it's part of the family 🧚.

---

👑 API 👑

⭐ ::tcl::transform::spacer chan n ?space?

This command creates a spacer transformation on top of the channel chan and returns its handle. That's your lil ticket to the whole operation 💖.

The space character sequence gets added every n bytes of data written. And on the read side, the same thing happens in reverse — the spacing gets removed. Symmetry, we love to see it 🌈.

If space is not specified, it defaults to a single space character (ASCII 32). Just one lil space. A classic 🎀.

---

💀 BUGS, IDEAS, FEEDBACK 💀

This document, and the package it describes, will undoubtedly contain bugs and other problems. Yes bestie, undoubtedly. That's just how it is 😭.

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. We want your thoughts, fr fr 🫶.

When proposing code changes, please provide unified diffs, i.e the output of diff -u. Don't just vibe-describe it, give us the diff 💅.

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 way, iykyk 👑.

---

🔥 KEYWORDS 🔥

• channel transformation
• reflected channel
• spacing
• tip 230
• transformation
• virtual channel

---

🎀 CATEGORY 🎀

Channels

---

💜 COPYRIGHT 💜

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

---

okay that's the whole page, bestie, you ate it 🍓. this was brought to you by tcllib, version 1.1 — mwah, go forth and space your bytes responsibly 💅✨