IO::Ca...ellfix(3pm)

💖 IO::Capture::Tellfix — the group chat version 💖

okay bestie so you're reading a User Contributed Perl Documentation page, and the man page name got chopped to IO::Ca...ellfix(3pm) because Unix hates long names, but the real one is right there below. sit down, hydrate, we're fixing a bug 🫶

---

✨ NAME ✨

IO::Capture::Tellfix — literally here to Fix the ::Tie_STDx TELL() issue. no cap, that's the whole job 💅

---

🌸 VERSION 🌸

This document describes IO::Capture::Tellfix version 0.05. she's grown up a little, we love her 🎀

---

⭐ SYNOPSIS ⭐

the way you just do this:

use IO::Capture::Stderr;
use IO::Capture::Tellfix;

that's it. that's the vibe. load them, let them cook 🔥

---

🦋 DESCRIPTION 🦋

so here's the tea, bestie: IO::Capture::Tie_STDx does not implement a TELL() method. like, at all. not a thing. the bug has been reported to the author (good for whoever did that, honestly 👑), but meanwhile a fix is needed. so we made one.

IO::Capture::Tellfix works around this bug, and the logic goes like this:

1. IO::Capture::Stdout is loaded, if it's not already.
2. tell(*STDOUT) is attempted.
3. if the tell fails, then the workaround is loaded.

and the hope? the hope is that this will play equally well with the current version and any future version that does or does not fix the TELL bug. future-proof queen behavior, we stan 🌈

ngl this is a workaround, not a flex. it exists because something is broken upstream. the original page is honest about that and so am I 💀

---

💜 AUTHOR 💜

Xiong Changnian <XIONG@cpan.org>

---

🎀 LICENCE AND COPYRIGHT 🎀

Copyright (c) 2010, Xiong Changnian <XIONG@cpan.org>. All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. iykyk, Perl terms, iconic ✨

---

🙈 DISCLAIMER OF WARRANTY 🙈

okay bestie this next part is the legal bit and it is entirely in all caps, which is honestly giving main character energy but also please actually read it because it's real:

BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENCE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

---

and that's the whole page, bestie!! 🥳 go tell on *STDOUT and let the workaround do its little thing 💖

sign-off szn 🫶 — this page came to you from perl v5.42.0, dated 2025-07-25, filed under that little truncated name IO::Ca...ellfix(3pm) because even the man page headers can't handle the full glow-up. mwah 💅🌸✨