blt::cutbuffer(3tcl)

💖 blt::cutbuffer — the Tcl manual, but make it cute 💖

okay bestie, so this one lives in the BLT Built-In Commands section of the Tcl manual, and it's called blt::cutbuffer. it's giving clipboard-adjacent main character energy and i'm obsessed. let's get into it 🫶

✨ NAME ✨

cutbuffer — manipulate X cut buffer properties 🌈

✨ SYNOPSIS ✨

cutbuffer get ?number?
cutbuffer rotate ?count?
cutbuffer set value ?number?

like, three whole operations, three whole moods. slay. 💅

✨ DESCRIPTION ✨

so the cutbuffer command lets you read or modify the eight X cut buffer properties. that's right, bestie — eight of them, not seven, not nine, eight ✨

and because that's not enough chaos for one command, you can also rotate the buffer properties. no cap. the buffers just... spin. 🌀

✨ OPERATIONS ✨

these are the operations available for the cutbuffer command, and yes we're going through every single one, i don't skip 👑

• cutbuffer get ?number? — returns the value of cutbuffer number. number has to be a number between 0 and 7, and if you don't say anything the default is 0. the cutbuffer comes back to you exactly, with one lil exception: NUL bytes get converted to '@' characters. wild, i know 😭 and if a cut buffer number doesn't exist? you get "" back. nothing. silence. a void. 💀
• cutbuffer rotate ?count? — rotates the cut buffers by count. count has to be a number between -7 and 7, and the default is 1. note the negative numbers are valid here, so you can spin it either way, iconique 🎀
• cutbuffer set value ?number? — sets the cutbuffer number to value. number has to be a number between 0 and 7, and yeah, default is 0. simple, clean, ate 🔥

heads up bestie: the 0 to 7 range on number is not a suggestion, it's the law, and count living between -7 and 7 is equally non-negotiable. don't test it 🙈

✨ KEYWORDS ✨

cut buffer, property 🦋

and that's the whole thing! this page came to you from BLT 2.5, dated back in the day, in the blt::cutbuffer(3tcl) manual section. mwah, go read a cut buffer or something 💜✨🌸