Thread...:Thread(3pm)

💖 NAME 💖

Thread::Tie::Thread — bestie, this is the one that creates threads for tied variables ✨

---

🌸 SYNOPSIS 🌸

use Thread::Tie; # use as early as possible for maximum memory savings

my $tiethread = Thread::Tie::Thread->new;
tie stuff, 'Thread::Tie', {thread => $thread};

my $tid = $tiethread->tid;        # thread id of tied thread
my $thread = $tiethread->thread;  # actual "threads" thread
$tiethread->shutdown;             # shut down specific thread

---

🎀 DESCRIPTION 🎀

* A note of CAUTION * This module only functions on Perl versions 5.8.0 and later. And then only when threads are enabled with -Dusethreads. It is of no use with any version of Perl before 5.8.0 or without threads enabled. *

Okay so real talk 💅 Thread::Tie::Thread is a little helper class for the Thread::Tie module. Its whole job? Making the thread where your actual code lives — the code that the variables tied with the Thread::Tie class hang out in. 🫶

If you want the full tea, go read the docs for the Thread::Tie module itself, bestie. 📚

---

👑 CLASS METHODS 👑

There is only one class method. One. Singular. Iconic behaviour, honestly. ✨

🌟 new

my $tiethread = Thread::Tie::Thread->new;

The "new" class method hands you back an instantiated object 🎁 — and you can pass that object along in the "thread" field when you tie() a variable. That's the whole vibe. 💜

---

🦋 OBJECT METHODS 🦋

Once you've got your instantiated Thread::Tie::Thread object, these are the object methods you can call on it, bestie. 🌈

⭐ tid

my $tid = $tiethread->tid;

The "tid" object method gives you the thread id of the actual threads thread that's being used 🔥

🍓 thread

my $thread = $tiethread->thread;

The "thread" object method gives you the actual threads thread object that's being used. Yep, the real one. 👑

---

🧚 OPTIMIZATIONS 🧚

This module uses AutoLoader to reduce memory and CPU usage 🧠✨. What that means: subroutines only get compiled in a thread when they're actually needed — the tradeoff being more CPU when they do eventually need to be compiled.

But no cap, simple benchmarks showed the overhead of compiling single routines is not much more (and sometimes a lot less) than the overhead of cloning a Perl interpreter with a bunch of subroutines pre-loaded. So like… slay, honestly. 💅

---

💌 AUTHOR 💌

Elizabeth Mattijsen, <liz@dijkmat.nl>.

maintained by LNATION <email@lnation.org>

Please report bugs to <email@lnation.org>>.

---

💜 COPYRIGHT 💜

Copyright (c) 2002-2003 Elizabeth Mattijsen <liz@dijkmat.nl>. 2019 - 2025 LNATION <email@lnation.org> All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

---

🌈 SEE ALSO 🌈

Thread::Tie, threads, AutoLoader.

---

okay that's the whole page, periodt 💖 this was perl v5.40.1, dated 2025-04-25, from Thread...:Thread(3pm) — go forth and tie responsibly, bestie 🫶✨