tcl::t...rm::rot(3tcl)

💖 tcl::transform::rot — the rot-encryption glow-up 💖

okay bestie, welcome to the tcl::transform::rot page from the tcllib manual, section 3tcl. it's giving ✨channel transformation✨ and honestly? she's iconic.

---

🌸 NAME 🌸

tcl::transform::rot — rot-encryption, no cap 🎀

---

🦋 SYNOPSIS 🦋

package require Tcl 8.6 9

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

package require tcl::transform::rot ?1.1?

::tcl::transform::rot chan key

like. look at her. four whole lines of pure main character energy 💅

---

💜 DESCRIPTION 💜

so the tcl::transform::rot package hands you a command that makes a channel transformation. and what does that transformation do? bestie it does primitive encryption when you're writing, and decryption when you're reading, and it does it to the alphabetic characters specifically. 🫶

the algorithm? it's the Caesar-cipher, and one very specific variant of it is rot13. periodt. 🔥

a related transformation hangin' out in this same module is tcl::transform::otp — go say hi to her later, iykyk.

and the internal TclOO class that implements the transform handler? she's a subclass of the tcl::transform::core framework. classy. literal queen behavior 👑

---

✨ API ✨

• ::tcl::transform::rot chan key — this command creates a rot encryption transformation sitting on top of the channel chan, and gives you back its handle. 🎀

the key tells it how far characters get rotated in the alphabet, and it gets wrapped to the range 0...25. 🔁

ok important thing bestie, listen: this transformation only touches bytes in the ranges ASCII 65...90 and 97...122. that's the upper- and lower-case alphabetic characters, aka "A...Z" and "a...z". every other byte just passes straight through, untouched, unbothered, moisturized, in her lane. 💅

---

😭 BUGS, IDEAS, FEEDBACK 😭

ngl, this document — and the package it describes — will undoubtedly contain bugs and other problems. it's not a vibe, it's just facts. 😔

so please report them in the category virtchannel of the Tcllib Trackers at http://core.tcl.tk/tcllib/reportlist. and if you've got ideas for enhancements for either the package and/or the documentation, send those too, we're obsessed with hearing them 💖

when you're proposing code changes, please provide unified diffs, i.e. the output of diff -u. no chaos, we're organized here. ✨

also note: attachments are strongly preferred over inlined patches. to attach something, go to the Edit form of the ticket right after it's created, then use the left-most button in the secondary navigation bar. that's the move 🫶

---

🎀 KEYWORDS 🎀

caesar cipher, channel transformation, cipher, decryption, encryption, reflected channel, rot, rot13, 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, tysm for reading 🥹💖 this was tcllib version 1.1, page tcl::transform::rot from section 3tcl — slay, bye 🦋✨💅