term::send(n)

📦
version 2.0 · 2 versions
, in fedora 43, fedora 44, nixos 26.05, nixpkgs unstable

💖 term::send(n) — ok bestie, we're talking to terminals now 💖

sooo this is the manual page for term::send, hanging out in the Terminal control section of the tcllib docs. It's giving "tiny package, big feelings" energy, and honestly? We're obsessed. 🎀

✨ NAME ✨

term::send — General output to terminals 💅

🌸 SYNOPSIS 🌸

package require Tcl 8.5 9

package require term::send ?0.2?

::term::send::wrch chan str

::term::send::wr str
quick vibe check: that ?0.2? means the version is optional-ish in the way manpages write these things — copy it exactly as shown, don't get cute with it. 🫶

🦋 DESCRIPTION 🦋

Okay so here's the tea: this package gives you the most primitive commands for yeeting characters at a terminal. That's it. That's the whole job. ✨

They are, in essence, convenient wrappers around the builtin command puts. Lowkey iconic behavior — no cap.

💜 the commands, one by one

  • ::term::send::wrch chan str — sends the text str to the channel specified by the handle chan. Now here's where it differs from the builtin puts: this one does NOT terminate the string with a line terminator. Not even a little. It also forces a flush of Tcl internal buffers and OS buffers, so you know for a fact those characters get processed immediately. No lingering in buffer limbo, bestie. 🫶
  • ::term::send::wr str — this is the convenience command, and it's basically ::term::send::wrch but the destination channel is fixed to stdout. Same energy, fewer arguments. Main character shortcut. 👑

😭 BUGS, IDEAS, FEEDBACK 😭

Not me having to say this, but: this document, and the package it describes, will undoubtedly contain bugs and other problems. Fr fr. It's not a vibe, it's just reality. 💀

Please report such in the category term of the Tcllib Trackers at:

http://core.tcl.tk/tcllib/reportlist

Also please report any ideas for enhancements you may have for either the package and/or the documentation. We want them. Give them to us. 🎀

When proposing code changes, please provide unified diffs, i.e. the output of diff -u. That's the format, that's the assignment, that's periodt.

heads up: attachments are strongly preferred over inlined patches. To attach something, go to the Edit form of the ticket immediately after its creation, and then use the left-most button in the secondary navigation bar. iykyk. 🦋

🌈 KEYWORDS 🌈

character output, control, terminal

👑 CATEGORY 👑

Terminal control

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

and that's the whole page, bestie — this beauty comes to you from tcllib, version 0.3, filed under term::send(n). Go forth and flush your buffers. Slay. 💅✨🦋🌸🎀

📦 where this page comes from