Term::C...:_POSIX(3)

📦
version 1.02 · 2 versions
, in fedora 43

💖 Term::C...:_POSIX(3) 💖

okay bestie, so this page lives in the User Contributed Perl Documentation section of the manual, and it's all about Term::Completion::_POSIX. Yeah, the name has a little ... in the middle — that's not a typo, that's just how the manpage names it, iykyk. 🫶

✨ NAME ✨

Term::Completion::_POSIX — it's the utility package for Term::Completion that uses POSIX termios. lowkey the behind-the-scenes bestie doing the real work. 💅

🌸 DESCRIPTION 🌸

So basically? This utility package has a few methods that Term::Completion literally needs in order to flip your terminal into "raw" mode and then back again. It pulls this off using POSIX termios, which means it should be portable across, like, a ton of UNIX-like systems. 🌈

And no cap — it was successfully tested on Solaris and Linux. she's been around the block and she still serves. 💖

🎀 Methods 🎀

  • set_raw_tty() — uses POSIX::Termios in POSIX plus the related methods to put the terminal into "raw" mode. Translation? It switches off the meaning of any control characters — think CTRL-C and friends — so they stop doing their little thing. 😌 The echo of characters gets switched off too, so the program has full control over what's typed and what's displayed. main character energy, honestly. 👑

It grabs the input file handle from the "in" field of the Term::Completion object. And heads up — it won't do anything if this is not a TTY, so don't come for it. 🚫 Also see -X in perlfunc. ✨

  • reset_tty() — puts the terminal back to its previous state, the one that got saved in the object's fields (_tty_XXX). undoing the makeover and returning her to her natural state. 🦋
  • get_key() — reads one byte from the input handle. Internally it uses getc in perlfunc. one byte at a time, bestie, that's the vibe. ⭐

👑 AUTHOR 👑

Marek Rouchal <marekr@cpan.org>

Some ideas were borrowed from IO::Stty by Austin Schutz. credit where credit is due, we love to see it. 🫶

Copyright (c) 2009, Marek Rouchal. All Rights Reserved.

This module is free software. It may be used, redistributed and/or modified under the same terms as Perl itself. slay, honestly. periodt. 💅

🔥 SEE ALSO 🔥

  • POSIX
  • IO::Stty

okay that's the whole page, bestie, you're officially caught up. this beauty shipped as part of perl v5.42.0, dated 2025-07-25, and it's filed under Term::C...:_POSIX(3). go forth and raw-mode responsibly. mwah. 💖✨🎀

📦 where this page comes from