waitVariableX(3pm)

💖 NAME 💖

okay so bestie, meet Tk::waitVariableX — it's literally a waitVariable with extensions, fr fr. That's the whole vibe. It lives in the perl/Tk Documentation corner of the world and its manual page goes by waitVariableX(3pm). 🫶

---

✨ SYNOPSIS ✨

use Tk::waitVariableX;

$splash->waitVariableX( [$millis, $destroy_splashscreen], \$v1, \$v2} );

---

🦋 DESCRIPTION 🦋

So this subroutine waits for a list of variables, but with a timeout in the mix. It comes back to you the moment one of those variables changes value, <em>or</em> when the timeout runs out — whichever one happens first. No cap, it's just first-come-first-served between "something changed" and "time's up". ⏰

Now here's the thing about that millisecond parameter: even though it is required, it's allowed to be zero, and a zero there means no timeout at all. The millisecond parameter can also be an array of two elements — element one is the millisecond value, and element two is a normal Per/Tk callback. That callback gets invoked just before waitVariableX returns. 👑

And the callback format? It's patterned after the Perl/Tk scheme, so you've got two options: hand over a code reference, <em>or</em> hand over an array reference and pass the callback code reference as the first element of that array, followed by the callback arguments. Pick your fighter, both slay. 💅

---

🎀 COPYRIGHT 🎀

Copyright (C) 2000 - 2002 Stephen O. Lidie. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. 🌈

---

and that's the whole page, bestie 🦋 — this was Tk::waitVariableX from the Tk1.0 era, dated 2022-06-28, and the manual page itself answers to waitVariableX(3pm). go forth and wait on your variables with impeccable main character energy. periodt. 💖✨🎀