Term::Complete(3perl)

💖 NAME 💖

Term::Complete — the Perl word completion module, bestie. it's giving tab-completion but make it yours 🎀

---

✨ SYNOPSIS ✨

$input = Complete('prompt_string', \@completion_list);
$input = Complete('prompt_string', @completion_list);

🌸 DESCRIPTION 🌸

okay so here's the vibe: this routine hands you word completion over the list of words living in an array (or an array ref, whichever you're feeling 🦋).

It throws the tty driver into raw mode, then restores it after using an operating-system-specific command — and in UNIX-like environments that command is literally stty 💅

These command characters are the whole personality of this module:

• <tab> — tries to complete your word. no cap, you cannot change this one. it's locked in. 🔒
• ^D — prints the completion list. this one's defined by $Term::Complete::complete. 👑
• ^U — erases whatever you've currently typed. defined by $Term::Complete::kill. bye bye input 💀
• <del>, <bs> — erases exactly one character. defined by $Term::Complete::erase1 and $Term::Complete::erase2. one (1) character, no more 🙈

---

💀 DIAGNOSTICS 💀

when word completion fails, the terminal hits you with a bell 🔔. that's the whole notification system. it's giving "nope, not today."

---

😭 BUGS 😭

the completion character <tab> cannot be changed. periodt. that's not a suggestion, that's just how it is 🫶

---

⭐ AUTHOR ⭐

Wayne Thompson — the icon, the moment, the legend 👑

---

and that's the whole page, bestie!! this lovely little manpage shipped with perl v5.44.0 on 2026-10-17, and it's part of the Perl Programmers Reference Guide. go forth and complete some words 💜✨